# SMS.ru API

**Canonical:** https://apis.io/apis/sms-ru/sms-ru-api/  
**Provider:** SMS.ru — https://apis.io/providers/sms-ru/  
**Documentation:** https://sms.ru/docs/api/api_group_sms/cost

SMS.ru API is one of 2 APIs that [SMS.ru](https://apis.io/providers/sms-ru/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

SMS.ru API as documented publicly: 11 operations. Contract generated from the documentation by API Evangelist (2026-10-28); not the provider's own document.

## Operations (11)

| Method | Path | Summary |
|---|---|---|
| GET | `/callback.php` | GET /callback.php |
| GET | `/callback/get` | Retrieve the list of all webhook handlers previously added. |
| GET | `/my/balance` | Get current account balance on SMS.RU. |
| GET | `/my/limit` | Get information about daily limit and its usage |
| GET | `/my/senders` | Get list of approved senders |
| GET | `/sms/cost` | Check the cost of messages before sending. |
| GET | `/sms/send` | Send an SMS message via HTTP request. |
| GET | `/sms/status` | Check the status of sent SMS messages. |
| GET | `/stoplist/add` | Add a phone number to the stoplist. |
| GET | `/stoplist/del` | Delete a phone number from the stoplist. |
| GET | `/stoplist/get` | Get the complete stoplist of phone numbers added to your blocklist. |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/sms-ru/openapi/_ae-authored/sms-ru-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/sms-ru/json-schema/sms-ru-get-sms-cost-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/sms-ru/json-schema/sms-ru-get-my-limit-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/sms-ru/json-schema/sms-ru-get-sms-send-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/sms-ru/json-schema/sms-ru-get-sms-status-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/sms-ru/json-schema/sms-ru-get-stoplist-get-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/sms-ru/json-schema/sms-ru-get-callback-get-response-schema.json

## Other SMS.ru APIs (1)

- [SMS.ru API](https://apis.io/apis/sms-ru/sms-ru-api-2/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/sms-ru/sms-ru-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/sms-ru/.