SMS.ru

SMS.ru API

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.

Documentation GitHub OpenAPI

Operations 11

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. #

Specifications

⚙

OpenAPI

https://artifacts.apis.io/sms-ru/openapi/_ae-authored/sms-ru-openapi-generated.yml

Schemas & Data

📊

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

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/sms-ru:sms-ru-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.1.0
info:
  title: SMS.ru API
  version: '2026-10-28'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-28: 11 operation(s) read from 14 public documentation page(s) (each
    operation names its page in x-source). This is not the provider''s published contract; SMS.ru has published no machine-readable contract that
    the pipeline could find. Engine: anthropic.'
  x-evidence-tiers:
    code-example: 1
    documentation: 10
    pages-with-code: 14
    pages-read: 14
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-28'
  x-generator: generate-contract-from-docs.py
  x-engine: anthropic
  x-sources:
  - https://sms.ru/docs/api/api_group_sms/cost
  - https://sms.ru/docs/api/api_group_sms/send
  - https://sms.ru/docs/api/api_group_call/call
  - https://sms.ru/docs/api/api_group_sms/limit
  - https://sms.ru/docs/api/api_group_sms/status
  - https://sms.ru/docs/api/api_group_sms/balance
  - https://sms.ru/docs/api/api_group_call/code_call
  - https://sms.ru/docs/api/api_group_sms/api_senders
  - https://sms.ru/docs/api/api_group_stoplist/stoplist_add
  - https://sms.ru/docs/api/api_group_stoplist/stoplist_del
  - https://sms.ru/docs/api/api_group_stoplist/stoplist_get
  - https://sms.ru/docs/api/api_group_sms/api_group_webhook/callback_add
  - https://sms.ru/docs/api/api_group_sms/api_group_webhook/callback_del
  - https://sms.ru/docs/api/api_group_sms/api_group_webhook/callback_get
paths:
  /callback.php:
    get:
      operationId: get_callback_php
      tags:
      - Callback
      summary: GET /callback.php
      x-source: https://sms.ru/docs/api/api_group_sms/api_group_webhook/callback_add
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -d \"url=https://yoursite.ru/callback.php\" https://sms.ru/callback/add\\?api_id=[зарегистрируйтесь, чтобы получить api_id]\\\
          &json=1\n ← Назад Удалить webhook обработчик Далее → Отправка СМС сообщений из R-Keeper CRM (UCS) \n × \n Документация Отправители Домен\
          \ Товарный знак Компания ИП Шаблоны Авторизационные Сервисные API Отправка SMS Отправить СМС Узнать стоимость Баланс Проверить статус\
          \ Список о"
  /callback/get:
    get:
      operationId: get_callback_get
      tags:
      - Callback
      summary: Retrieve the list of all webhook handlers previously added.
      x-source: https://sms.ru/docs/api/api_group_sms/api_group_webhook/callback_get
      parameters:
      - name: api_id
        in: query
        required: true
        schema:
          type: string
        description: Your unique API key for authorization
      - name: json
        in: query
        required: false
        schema:
          type: integer
        description: Set to 1 to return JSON formatted response
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCallbackGetResponse'
      x-evidence:
        kind: documentation
  /my/balance:
    get:
      operationId: get_my_balance
      tags:
      - My
      summary: Get current account balance on SMS.RU.
      x-source: https://sms.ru/docs/api/api_group_sms/balance
      parameters:
      - name: api_id
        in: query
        required: true
        schema:
          type: string
        description: Unique API key for authorization
      - name: json
        in: query
        required: false
        schema:
          type: integer
        description: Set to 1 for detailed JSON response
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetMyBalanceResponse'
      x-evidence:
        kind: documentation
  /my/limit:
    get:
      operationId: get_my_limit
      tags:
      - My
      summary: Get information about daily limit and its usage
      x-source: https://sms.ru/docs/api/api_group_sms/limit
      parameters:
      - name: api_id
        in: query
        required: true
        schema:
          type: string
        description: Authorization using your unique key (api_id)
      - name: json
        in: query
        required: false
        schema:
          type: string
        description: Set to 1 to get detailed response in JSON format
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetMyLimitResponse'
      x-evidence:
        kind: documentation
  /my/senders:
    get:
      operationId: get_my_senders
      tags:
      - My
      summary: Get list of approved senders
      x-source: https://sms.ru/docs/api/api_group_sms/api_senders
      parameters:
      - name: api_id
        in: query
        required: true
        schema:
          type: string
        description: Unique API key for authorization
      - name: json
        in: query
        required: false
        schema:
          type: integer
        description: Enable JSON format response (set to 1)
      responses:
        '100':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetMySendersResponse'
      x-evidence:
        kind: documentation
  /sms/cost:
    get:
      operationId: get_sms_cost
      tags:
      - Sms
      summary: Check the cost of messages before sending.
      x-source: https://sms.ru/docs/api/api_group_sms/cost
      parameters:
      - name: api_id
        in: query
        required: true
        schema:
          type: string
        description: Authorization using your unique key (api_id).
      - name: to
        in: query
        required: true
        schema:
          type: string
        description: Recipient phone number (or multiple numbers separated by comma — up to 100 per request). Can also be specified as array to[phone_number]=text.
      - name: msg
        in: query
        required: true
        schema:
          type: string
        description: Message text in UTF-8 encoding.
      - name: multi
        in: query
        required: true
        schema:
          type: string
        description: To send different messages to multiple numbers in one request (up to 100 messages per 1 request). Use format multi[phone_number]=text.
          When using this parameter, 'to' and 'msg' are not needed.
      - name: json
        in: query
        required: false
        schema:
          type: integer
        description: Parameter value 1 causes server response in JSON format with more detailed data about messages.
      - name: from
        in: query
        required: false
        schema:
          type: string
        description: Sender name (must be agreed with administration). If not filled, your default sender will be used.
      - name: translit
        in: query
        required: false
        schema:
          type: integer
        description: Value 1 transliterates all Russian characters to Latin characters.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetSmsCostResponse'
      x-evidence:
        kind: documentation
  /sms/send:
    get:
      operationId: get_sms_send
      tags:
      - Sms
      summary: Send an SMS message via HTTP request.
      x-source: https://sms.ru/docs/api/api_group_sms/send
      parameters:
      - name: api_id
        in: query
        required: true
        schema:
          type: string
        description: Authorization by unique API key.
      - name: to
        in: query
        required: true
        schema:
          type: string
        description: Recipient phone number or multiple numbers separated by comma (up to 100 per request).
      - name: msg
        in: query
        required: true
        schema:
          type: string
        description: Message text in UTF-8 encoding.
      - name: json
        in: query
        required: false
        schema:
          type: integer
        description: Response in JSON format with more detailed information about sent messages.
      - name: from
        in: query
        required: false
        schema:
          type: string
        description: Sender name (must be agreed with administration).
      - name: ip
        in: query
        required: false
        schema:
          type: string
        description: User IP address for protection against abuse.
      - name: time
        in: query
        required: false
        schema:
          type: string
        description: Delayed send time in UNIX TIME format (no more than 2 months from request submission).
      - name: ttl
        in: query
        required: false
        schema:
          type: integer
        description: Message time-to-live in minutes (1 to 1440).
      - name: daytime
        in: query
        required: false
        schema:
          type: integer
        description: Considers recipient timezone; if night (20:00), delays until 10:00 AM.
      - name: translit
        in: query
        required: false
        schema:
          type: integer
        description: Transliterates Russian characters to Latin.
      - name: test
        in: query
        required: false
        schema:
          type: integer
        description: Test mode to simulate message sending without actual delivery or balance deduction.
      - name: partner_id
        in: query
        required: false
        schema:
          type: string
        description: Unique partner identifier for affiliate program participation.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetSmsSendResponse'
      x-evidence:
        kind: documentation
  /sms/status:
    get:
      operationId: get_sms_status
      tags:
      - Sms
      summary: Check the status of sent SMS messages.
      x-source: https://sms.ru/docs/api/api_group_sms/status
      parameters:
      - name: api_id
        in: query
        required: true
        schema:
          type: string
        description: Authorization using your unique key (api_id).
      - name: sms_id
        in: query
        required: true
        schema:
          type: string
        description: Message identifier(s) obtained from the sms/send method. Multiple identifiers can be specified comma-separated (up to 100
          at a time).
      - name: json
        in: query
        required: false
        schema:
          type: integer
        description: This parameter causes the server response in JSON format with more data about sent messages.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetSmsStatusResponse'
      x-evidence:
        kind: documentation
  /stoplist/add:
    get:
      operationId: get_stoplist_add
      tags:
      - Stoplist
      summary: Add a phone number to the stoplist.
      x-source: https://sms.ru/docs/api/api_group_stoplist/stoplist_add
      parameters:
      - name: api_id
        in: query
        required: true
        schema:
          type: string
        description: Unique API key for authorization.
      - name: stoplist_phone
        in: query
        required: true
        schema:
          type: string
        description: Phone number to add to the stoplist.
      - name: stoplist_text
        in: query
        required: true
        schema:
          type: string
        description: Note to the number (reason for adding to stoplist).
      - name: json
        in: query
        required: false
        schema:
          type: integer
        description: Parameter that triggers server response in JSON format with more detailed data.
      responses:
        '100':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetStoplistAddResponse'
      x-evidence:
        kind: documentation
  /stoplist/del:
    get:
      operationId: get_stoplist_del
      tags:
      - Stoplist
      summary: Delete a phone number from the stoplist.
      x-source: https://sms.ru/docs/api/api_group_stoplist/stoplist_del
      parameters:
      - name: api_id
        in: query
        required: true
        schema:
          type: string
        description: Authorization using your unique API key (api_id).
      - name: stoplist_phone
        in: query
        required: true
        schema:
          type: string
        description: Phone number to be removed from the stoplist.
      - name: json
        in: query
        required: false
        schema:
          type: string
        description: This parameter triggers server response in JSON format with more data about sent messages.
      responses:
        '100':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetStoplistDelResponse'
      x-evidence:
        kind: documentation
  /stoplist/get:
    get:
      operationId: get_stoplist_get
      tags:
      - Stoplist
      summary: Get the complete stoplist of phone numbers added to your blocklist.
      x-source: https://sms.ru/docs/api/api_group_stoplist/stoplist_get
      parameters:
      - name: api_id
        in: query
        required: true
        schema:
          type: string
        description: Your unique API key for authorization
      - name: json
        in: query
        required: false
        schema:
          type: integer
        description: Set to 1 to receive a detailed JSON response
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetStoplistGetResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    GetCallbackGetResponse:
      type: object
      properties:
        status:
          type: string
          description: Request execution status (OK for success)
        status_code:
          type: integer
          description: Status code of execution (100 for success)
        callback:
          type: array
          description: List of added webhook URLs
    GetMyBalanceResponse:
      type: object
      properties:
        status:
          type: string
          description: Request status (OK if successful)
        status_code:
          type: integer
          description: Execution status code (100 for success)
        balance:
          type: number
          description: Current account balance
    GetMyLimitResponse:
      type: object
      properties:
        status:
          type: string
          description: Request status (OK if successful)
        status_code:
          type: integer
          description: Status code (100 for success)
        total_limit:
          type: integer
          description: Total daily limit for sending messages
        used_today:
          type: integer
          description: Number of phone numbers already sent messages to today
    GetMySendersResponse:
      type: object
      properties:
        status:
          type: string
          description: Request execution status (OK for success)
        status_code:
          type: integer
          description: Status code (100 for success)
        senders:
          type: array
          description: Array of approved sender names
    GetSmsCostResponse:
      type: object
      properties:
        status:
          type: string
          description: Request execution result (OK or error description)
        status_code:
          type: integer
          description: Status code
        sms:
          type: object
          description: Details for each phone number with status, status_code, cost, and sms count
        total_cost:
          type: number
          description: Total cost of all messages
        total_sms:
          type: integer
          description: Total number of SMS messages
    GetSmsSendResponse:
      type: object
      properties:
        status:
          type: string
          description: Request status (OK or ERROR).
        status_code:
          type: integer
          description: Status code (e.g., 100 for success).
        sms:
          type: object
          description: Object containing results for each recipient phone number.
        balance:
          type: number
          description: Account balance after sending.
    GetSmsStatusResponse:
      type: object
      properties:
        status:
          type: string
          description: OK or ERROR
        status_code:
          type: integer
          description: Status code (100 for successful execution)
        sms:
          type: object
          description: Object containing status information for each SMS message
        balance:
          type: number
          description: Account balance after the operation
    GetStoplistAddResponse:
      type: object
      properties:
        status:
          type: string
          description: Request execution status (OK indicates success).
        status_code:
          type: integer
          description: Execution status code (100 for success).
    GetStoplistDelResponse:
      type: object
      properties:
        status:
          type: string
          description: Request executed successfully (no authorization errors).
        status_code:
          type: integer
          description: Successful execution code.
    GetStoplistGetResponse:
      type: object
      properties:
        status:
          type: string
          description: Request execution status (OK indicates success)
        status_code:
          type: integer
          description: Status code (100 for success)
        stoplist:
          type: object
          description: Object containing phone numbers as keys and notes as values
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: Authorization
security:
- apiKey: []
tags:
- name: Callback
- name: My
- name: Sms
- name: Stoplist