{"id":3509,"date":"2026-01-13T10:09:09","date_gmt":"2026-01-13T07:09:09","guid":{"rendered":"https:\/\/docs.unibell.tech\/?page_id=3509"},"modified":"2026-04-09T10:02:22","modified_gmt":"2026-04-09T07:02:22","slug":"sms-api","status":"publish","type":"page","link":"https:\/\/docs.unibell.tech\/?page_id=3509","title":{"rendered":"SMS API"},"content":{"rendered":"\n

Sending SMS messages<\/h2>\n\n\n\n

For information about the authentication and authorization procedures that associate API calls with the required applications in your account, see Authorization<\/a>.<\/p>\n\n\n\n

Request:<\/strong><\/p>\n\n\n\n

Parameters can be passed in the request headers:<\/p>\n\n\n\n

POST\/GET https:\/\/api.unibell.ru\/v2\/sms?X-Authorization=AccessKey d8ac9959r12b43545XXXXX&destAddr=7XXXXXXXXXX&sourceAddr=MySender&shortMessage=Message text<\/code><\/pre>\n\n\n\n
As well as in the request body:<\/p>\n\n\n\n
{\n    \"sourceAddr\": \"MySender\",\n    \"destAddr\": \"7XXXXXXXXXX\",\n    \"shortMessage\": \"Message text\"\n}<\/code><\/pre>\n\n\n\n
Example request using CURL:<\/strong><\/p>\n\n\n\n
curl --location --request POST 'https:\/\/api.unibell.ru\/v2\/sms?X-Authorization=AccessKey%20d8ac9959r12b43545XXXXX&destAddr=7XXXXXXXXXX&sourceAddr=MySender&shortMessage=Message text'<\/code><\/pre>\n\n\n\n
curl --location 'https:\/\/api.unibell.ru\/v2\/sms?=' \\\n--header 'X-Authorization: AccessKey d8ac9959r12b43545XXXXX' \\\n--header 'Content-Type: application\/json' \\\n--data '{\n    \"sourceAddr\": \"MySender\",\n    \"destAddr\": \"7XXXXXXXXXX\",\n    \"shortMessage\": \"Message text\"\n}'<\/code><\/pre>\n\n\n\n
Parameter<\/th>Type<\/th>Description<\/th><\/tr><\/thead>
sourceAddr<\/strong><\/td>string<\/td>Sender name (Latin letters only or phone number)
The field must not contain Cyrillic characters<\/em><\/strong><\/td><\/tr>
destAddr<\/strong><\/td>string<\/td>Phone number to which the SMS is sent, in e.164 format, for example, for the Russian Federation: 7XXXXXXXXXX
7XXXXXXXXXX<\/td><\/tr>
shortMessage<\/strong><\/td>string<\/td>Message text<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Response upon successful request execution:<\/strong><\/p>\n\n\n\n
{\n    \"status\": \"Created\",\n    \"requestId\": \"11273\"\n}<\/code><\/pre>\n\n\n\n
Response in case destAddr<\/code> is missing:<\/strong><\/p>\n\n\n\n
{\n    \"status\": \"Rejected\",\n    \"error\": \"Missing destAddr param\"\n}<\/code><\/pre>\n\n\n\n
Parameter<\/th>Type<\/th>Description<\/th><\/tr><\/thead>
status<\/strong><\/td>string<\/td>Request status:
Created – Message created in the system but not yet sent
Rejected – Message was not accepted for sending, see error for details
prohibitedForServiceError – Key does not belong to the SMS service
invalidAccessKeyError – Authorization key error<\/sub>
accountFinanciallyBlocked \u2014 The customer is blocked by the balance\/Blocking by IP address<\/sub><\/td><\/tr>
requestId<\/strong><\/td>string<\/td>Unique request identifier<\/td><\/tr>
error<\/strong><\/td>string<\/td>Error description:
Missing destAddr param – destAddr is missing in the request
Missing sourceAddr param – sourceAddr is missing in the request
Missing shortMessage param – shortMessage is missing in the request
Field sourceAddr must not contain Cyrillic – sourceAddr contains Cyrillic characters<\/sub><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Bulk SMS message sending<\/h2>\n\n\n\n
Request:<\/strong><\/p>\n\n\n\n
POST\/GET https:\/\/api.unibell.ru\/v2\/sms_bulk?X-Authorization=AccessKey d8ac9959r12b43545XXXXX<\/code><\/pre>\n\n\n\n
Request body:<\/p>\n\n\n\n
{\n    \"sourceAddr\": \"MySender\",\n    \"destAddrs\": [\n        \"79123213232\",\n        \"2\u0432\u0430\u0443\u0446\",\n        \"71233212323\"\n    ],\n    \"shortMessage\": \"Message text\"\n}<\/code><\/pre>\n\n\n\n
Example request using CURL:<\/strong><\/p>\n\n\n\n
curl --location 'https:\/\/api.unibell.ru\/v2\/sms_bulk' \\\n--header 'X-Authorization: AccessKey d8ac9959r12b43545XXXXX' \\\n--header 'Content-Type: application\/json' \\\n--data '{\n    \"sourceAddr\": \"MySender\",\n    \"destAddrs\": [\n        \"79123213232\",\n        \"2\u0432\u0430\u0443\u0446\",\n        \"71233212323\"\n    ],\n    \"shortMessage\": \"Message text\"\n}'<\/code><\/pre>\n\n\n\n
Parameter<\/th>Type<\/th>Description<\/th><\/tr><\/thead>
sourceAddr<\/strong><\/td>string<\/td>Sender name
The field must not contain Cyrillic characters<\/em><\/strong><\/td><\/tr>
destAddrs<\/strong><\/td>string<\/td>List of phone numbers to which SMS messages are sent, in e.164 format, for example, for the Russian Federation: 7XXXXXXXXXX<\/td><\/tr>
shortMessage<\/strong><\/td>string<\/td>Message text<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Response body upon request execution:<\/strong><\/p>\n\n\n\n
{\n    \"status\": \"ok\",\n    \"results\": [\n        {\n            \"status\": \"Created\",\n            \"requestId\": \"11276\",\n            \"destAddr\": \"79123213232\"\n        },\n        {\n            \"status\": \"Rejected\",\n            \"error\": \"Not valid destAddr\",\n            \"destAddr\": \"2test\"\n        },\n        {\n            \"status\": \"Created\",\n            \"requestId\": \"11277\",\n            \"destAddr\": \"71233212323\"\n        }\n    ]\n}<\/code><\/pre>\n\n\n\n
Parameter<\/th>Type<\/th>Description<\/th><\/tr><\/thead>
status<\/strong><\/td>string<\/td>Request status:
Created – Message created in the system but not yet sent
Enroute – Message routed and awaiting sending
Delivered – Message delivered, delivery status received from operator
Expired – Message lifetime expired
Deleted – Message was canceled
Undeliverable – Message not delivered due to reasons such as: number does not exist, no space for new SMS on the phone
Accepted – Message sent, delivery status from operator not yet received
Unknown – Unknown error
Rejected – Message was not accepted for sending, see error for details
prohibitedForServiceError – Key does not belong to the SMS service
invalidAccessKeyError – Authorization key error<\/sub>
accountFinanciallyBlocked \u2014 The customer is blocked by the balance\/Blocking by IP address<\/sub><\/td><\/tr>
results<\/strong><\/td>string<\/td>Results for each recipient<\/td><\/tr>
error<\/strong><\/td>string<\/td>Error description:
Missing destAddr param – destAddr is missing in the request
Missing sourceAddr param – sourceAddr is missing in the request
Missing shortMessage param – shortMessage is missing in the request
Field sourceAddr must not contain Cyrillic – sourceAddr contains Cyrillic characters
Not valid destAddr – destAddr is invalid<\/sub><\/td><\/tr>
requestId<\/strong><\/td>string<\/td>Unique request identifier<\/td><\/tr>
destAddr<\/strong><\/td>string<\/td>Phone number to which the SMS is sent, in e.164 format, for example, for the Russian Federation: 7XXXXXXXXXX<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Retrieving status<\/h2>\n\n\n\n
Request:<\/strong><\/p>\n\n\n\n
Parameters can be passed in the request headers:<\/p>\n\n\n\n
GET https:\/\/api.unibell.ru\/v2\/sms_status?X-Authorization=AccessKey d8ac9959r12b43545XXXXX&requestId=11273<\/code><\/pre>\n\n\n\n
As well as in the request body:<\/p>\n\n\n\n
{\n    \"requestId\": \"11273\"\n}<\/code><\/pre>\n\n\n\n
Example requests using CURL:<\/strong><\/p>\n\n\n\n
curl --location 'https:\/\/api.unibell.ru\/v2\/sms_status' \\\n--header 'X-Authorization: AccessKey d8ac9959r12b43545XXXXX' \\\n--header 'requestId: 11273'<\/code><\/pre>\n\n\n\n
curl --location --request GET 'https:\/\/api.unibell.ru\/v2\/sms_status' \\\n--header 'X-Authorization: AccessKey d8ac9959r12b43545XXXXX' \\\n--header 'Content-Type: application\/json' \\\n--data '{\n    \"requestId\": \"11273\"\n}'<\/code><\/pre>\n\n\n\n
Response body upon successful request execution:<\/strong><\/p>\n\n\n\n
{\n    \"id\": 9654,\n    \"destAddr\": \"7XXXXXXXXXX\",\n    \"requestId\": \"11273\",\n    \"status\": \"Rejected\",\n    \"networkErrCode\": 34,\n    \"mcc\": 0,\n    \"mnc\": 0,\n    \"ported\": 0\n}<\/code><\/pre>\n\n\n\n
Response in case the requestId<\/code> parameter is missing:<\/strong><\/p>\n\n\n\n
{\n    \"status\": \"Rejected\",\n    \"error\": \"Missing requestId param\"\n}<\/code><\/pre>\n\n\n\n
Parameter<\/th>Type<\/th>Description<\/th><\/tr><\/thead>
id<\/td>integer<\/td>Unique SMS message identifier<\/td><\/tr>
destAddr<\/td>string<\/td>Phone number to which the SMS was sent, in e.164 format, for example, for the Russian Federation: 7XXXXXXXXXX<\/td><\/tr>
requestId<\/td>string<\/td>Unique request identifier<\/td><\/tr>
status<\/td>string<\/td>SMS sending request status:
Created – Message created in the system but not yet sent
Enroute – Message routed and awaiting sending
Delivered – Message delivered, delivery status received from the operator
Expired – Message lifetime expired
Deleted – Message was canceled
Undeliverable – Message not delivered due to reasons such as: number does not exist, no space for new SMS on the phone
Accepted – Message sent, delivery status from operator not yet received
Unknown – Unknown error
Rejected – Mobile network rejected the message, likely due to a filter or other restriction
notFound – Record for the requested requestId does not exist\/not found<\/sub><\/td><\/tr>
networkErrCode<\/td>string<\/td>SS7 errors, see below<\/a><\/td><\/tr>
mcc<\/td>integer<\/td>Mobile Country Code<\/td><\/tr>
mnc<\/td>integer<\/td>Mobile Network Code \u2013 mobile operator code<\/td><\/tr>
ported<\/td>integer<\/td>Indicates whether the number has been ported:
1 – if the number was ported
0 – if not ported<\/sub><\/td><\/tr>
error<\/td>string<\/td>if not ported
Missing requestId param – requestId is missing in the request<\/sub><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Retrieving message statuses via Webhook<\/h2>\n\n\n\n
Request source:<\/strong><\/p>\n\n\n\n
Webhooks will be sent from the IP addresses 185.175.44.211 and 46.148.235.62, which must be added to the ACL on the client\u2019s web server to ensure proper interaction.<\/p>\n\n\n\n
Interaction format:<\/strong><\/p>\n\n\n\n
Callbacks are performed over the HTTP protocol.<\/p>\n\n\n\n
Data is transmitted in JSON format.<\/p>\n\n\n\n
Webhook setup is performed by submitting a request to technical support.<\/p>\n\n\n\n
Sending a request:<\/strong><\/p>\n\n\n\n
The request is sent in JSON format, which has the following structure:<\/p>\n\n\n\n
{\n  \"ported\": 0,\n  \"mnc\": 0,\n  \"requestId\": \"35714061\",\n  \"destAddr\": \"7XXXXXXXXXX\",\n  \"id\": 639073386,\n  \"networkErrCode\": 0,\n  \"mcc\": 0,\n  \"status\": \"Delivered\"\n}<\/code><\/pre>\n\n\n\n
Parameter<\/th>Type<\/th>Description<\/th><\/tr><\/thead>
ported<\/td>integer<\/td>Indicates whether the number has been ported:
1 – if the number was ported
0 – if not ported<\/sub><\/td><\/tr>
mnc<\/td>integer<\/td>Mobile Network Code \u2013 mobile operator code<\/td><\/tr>
requestId<\/td>string<\/td>Unique request identifier<\/td><\/tr>
destAddr<\/td>string<\/td>Phone number to which the SMS is sent, in e.164 format, for example, for the Russian Federation: 7XXXXXXXXXX<\/td><\/tr>
id<\/td>integer<\/td>\u0423\u043d\u0438\u043a\u0430\u043b\u044c\u043d\u044b\u0439 \u0438\u0434\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0442\u043e\u0440 SMS-\u0441\u043e\u043e\u0431\u0449\u0435\u043d\u0438\u044f<\/td><\/tr>
networkErrCode<\/td>string<\/td>SS7 errors, see below<\/a><\/td><\/tr>
mcc<\/td>integer<\/td>Mobile Country Code<\/td><\/tr>
status<\/td>string<\/td>SMS sending request status:
Created – Message created in the system but not yet sent
Enroute – Message routed and awaiting sending
Delivered – Message delivered, delivery status received from the operator
Expired – Message lifetime expired
Deleted – Message was canceled
Undeliverable – Message not delivered due to reasons such as: number does not exist, no space for new SMS on the phone
Accepted – Message sent, delivery status from operator not yet received
Unknown – Unknown error
Rejected – Message was not accepted for sending, see error for details<\/sub><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Error codes in the status<\/h2>\n\n\n\n
Possible error codes in SMS status (networkErrCode<\/code>).<\/p>\n\n\n\n
All unspecified codes are considered vendor-dependent and are not handled separately.<\/p>\n\n\n\n
Code<\/th>Description Key<\/th>Description<\/th><\/tr><\/thead>
1<\/td>unknownSubscriber<\/td>Unknown subscriber
The subscriber is not registered in the network<\/sub><\/td><\/tr>
5<\/td>unidentifiedSubscriber<\/td>Unidentified subscriber
Subscriber is registered, but information about them is missing or unavailable<\/sub><\/td><\/tr>
9<\/td>illegalSubscriber<\/td>Illegal subscriber
Access denied due to rule violation<\/sub><\/td><\/tr>
11<\/td>teleserviceNotProvisioned<\/td>Telecommunication service not provisioned
Subscriber is not subscribed to the requested service<\/sub><\/td><\/tr>
13<\/td>callBarred<\/td>Call barred
Calls are prohibited for this subscriber (e.g., due to blocking or tariff restrictions)<\/sub><\/td><\/tr>
21<\/td>facilityNotSupported<\/td>Facility not supported
Requested service is unavailable for the subscriber or network<\/sub><\/td><\/tr>
27<\/td>adsentSubscriber<\/td>Address absent
Message not delivered due to missing sender information<\/sub><\/td><\/tr>
31<\/td>subscriberBusyForMT-SMS<\/td>Subscriber busy for MT-SMS
Subscriber cannot receive SMS due to device being busy<\/sub><\/td><\/tr>
32<\/td>sm-DeliverFailure<\/td>SMS delivery failure
General error related to SMS transmission<\/sub><\/td><\/tr>
33<\/td>messageWaitingListFull<\/td>Message waiting list full
Subscriber device memory has no space for new messages<\/sub><\/td><\/tr>
34<\/td>systemFailure<\/td>System failure
General network-side error<\/sub><\/td><\/tr>
35<\/td>dataMissing<\/td>Data missing
Insufficient information to complete the operation<\/sub><\/td><\/tr>
36<\/td>unexpectedDataValue<\/td>Unexpected data value
Incorrect or unexpected data provided<\/sub><\/td><\/tr>
100<\/td>RejectedByIpBlockedException<\/td>Blocking by IP address<\/td><\/tr>
101<\/td>RejectedByFinBlockedException<\/td>Financial lockdown<\/td><\/tr>
102<\/td>SmsTemplateRejectedException<\/td>The template was not found<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
SMS error codes<\/h2>\n\n\n\n
Code<\/strong><\/th>Name<\/strong><\/th>Description<\/strong><\/th><\/tr><\/thead>
0<\/td>No error<\/td>No errors. Subscriber exists and is available<\/td><\/tr>
1<\/td>Unknown subscriber<\/td>The subscriber\u2019s phone number does not exist, is inactive, or is no longer in use<\/td><\/tr>
2<\/td>Unknown subscriber \u2013 NR Changed<\/td>Number Portability error. May occur after multiple number portings<\/td><\/tr>
5<\/td>Unidentified subscriber<\/td>MSC cannot recognize the subscriber\u2019s IMSI. Possible causes: HLR not updated or MSC failure<\/td><\/tr>
6<\/td>Absent subscriber for SMS<\/td>Subscriber\u2019s device is unavailable for receiving SMS (phone is off or out of coverage)<\/td><\/tr>
7<\/td>Unknown equipment<\/td>Message rejected because the subscriber\u2019s device is unrecognized<\/td><\/tr>
8<\/td>Roaming not allowed<\/td>Message rejected due to authentication or filtering error while roaming<\/td><\/tr>
9<\/td>Illegal subscriber<\/td>Message rejected due to authentication or filtering error<\/td><\/tr>
10<\/td>Bearer Service not provisioned<\/td>Subscriber\u2019s plan does not support SMS<\/td><\/tr>
11<\/td>Teleservice not provisioned<\/td>Subscriber cannot receive SMS. Reasons: service not activated, subscriber roaming without SMS activation, or operator failed to enable SMS exchange<\/td><\/tr>
12<\/td>Illegal equipment<\/td>Message not delivered due to a phone or SIM error; device or network does not support SMS<\/td><\/tr>
13<\/td>Call barred<\/td>Subscriber blocked: zero\/negative balance, operator restriction, damaged SIM, or incorrect PIN\/PUK<\/td><\/tr>
21<\/td>Facility not supported<\/td>Subscriber\u2019s plan or device does not support SMS service<\/td><\/tr>
27<\/td>Absent subscriber<\/td>Subscriber\u2019s device not registered on the network (off or out of coverage)<\/td><\/tr>
28<\/td>Incompatible MS terminal error<\/td>SMS function not supported by the subscriber\u2019s mobile device<\/td><\/tr>
31<\/td>Subscriber busy for SM MT<\/td>Subscriber\u2019s device temporarily unavailable for SMS delivery<\/td><\/tr>
32<\/td>Equipment failure<\/td>Receiving device does not support SMS or the relevant function<\/td><\/tr>
33<\/td>MS memory capacity exceeded<\/td>Receiving device does not have enough memory to receive the message<\/td><\/tr>
34<\/td>GSM system failure<\/td>MSC rejected the message due to SS7 protocol failure or network error<\/td><\/tr>
35<\/td>GSM Data Error \u2013 data missing<\/td>GSM data missing<\/td><\/tr>
36<\/td>GSM Data Error<\/td>Incorrect GSM data<\/td><\/tr>
45<\/td>Subscriber busy<\/td>Subscriber currently cannot perform GSM operations<\/td><\/tr>
100<\/td>RejectedByIpBlockedException<\/td>Blocked by IP address<\/td><\/tr>
101<\/td>RejectedByFinBlockedException<\/td>Financial block<\/td><\/tr>
102<\/td>SmsTemplateRejectedException<\/td>Message template not found<\/td><\/tr>
500<\/td>Invalid destination address<\/td>Invalid recipient number<\/td><\/tr>
501-506<\/td>Routing error<\/td>Routing error<\/td><\/tr>
507<\/td>SystemFailure<\/td>General system failure<\/td><\/tr>
508<\/td>ThrottledException<\/td>Request or message limit exceeded (rate limit)<\/td><\/tr>
509<\/td>Invalid parameter length<\/td>Invalid message or parameter length<\/td><\/tr>
510<\/td>Invalid destination address<\/td>Invalid destination address<\/td><\/tr>
511<\/td>Loop detection error<\/td>Routing loop detected (cyclical sending)<\/td><\/tr>
512<\/td>Invalid source address<\/td>Invalid sender address<\/td><\/tr>
513<\/td>System error<\/td>Internal system error<\/td><\/tr>
999<\/td>Unspecified error<\/td>Unspecified error (general code without detailed cause)<\/td><\/tr><\/tbody><\/table><\/figure>\n","protected":false},"excerpt":{"rendered":"
Sending SMS messages For information about the authentication and authorization procedures that associate API calls with the required applications in your account, see Authorization. Request: Parameters can be passed in the request headers: As well as in the request body: Example request using CURL: Parameter Type Description sourceAddr string Sender name (Latin letters only or …  SMS API<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"tpl\/http-content.php","meta":{"footnotes":""},"class_list":["post-3509","page","type-page","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=\/wp\/v2\/pages\/3509","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=3509"}],"version-history":[{"count":10,"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=\/wp\/v2\/pages\/3509\/revisions"}],"predecessor-version":[{"id":3601,"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=\/wp\/v2\/pages\/3509\/revisions\/3601"}],"wp:attachment":[{"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=3509"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}