Developer Docs

Table of contents

SMS Sender registration by a legal entity

Method for submitting an application for registration of the SMS Sender’s name (Alpha-name) with a mobile operator by a subject legal entity.

Please note that Sender registration is not available in Demo and Test account modes.

To submit SMS Sender registration by a legal entity:


Request parameters:

country_codeYesstringNoThe country where it is necessary to register the Sender name. 
Must be specified according to the ISO 3166-1 Alpha-2 standard.
senderYesstringNoSender name. 
Up to 11 Latin letters or digits, up to 15 – only digits.
typeYesstringNoService for which the Sender is registered.
Available values: sms
code_of_companyYesstringNoCompany code.  Numeric value between 1 and 30 characters.
descriptionYesstringNoService description.
From 1 to 1 000 characters.
informing_purposeYesstringNoPurpose of informing.
From 1 to 1 000 characters.
site_urlNostringNoWebsite URL. 
Up to 150 characters.
Up to 1 000 characters.
legal_nameYesstringNoLegal name.
From 3 to 100 characters.
addressYesstringNoLegal address.
From 3 to 200 characters.
tax_numberYesstringNoTaxpayer number.
From 1 to 20 characters.

Request sample:

  "country_code": "UA",
  "type": "sms",
  "sender": "sender",
  "code_of_company": "string",
  "tax_number": "string",
  "description": "desc",
  "informing_purpose": "inf",
  "site_url": "",
  "comment": "comm",
  "legal_name": "juridical_name",
  "address": "juridical_address"

Response parameters:

idstringNumber of the application for Sender registration
senderstringSender name
namestringLast name, first name, and middle name
addressstringLegal address
statusstringStatus of the application for Sender registration. Possible values:
  • new – application created

  • accepted – accepted

  • in progress – in progress

  • registration completed – Sender registration completed

  • rejected – application for Sender registration rejected.
typestringSender type: sms
created_atstringDate of creating the application for Sender registration.
Format: yyyy-mm-dd hh:mm:ss
country_codestringSender country – country code according to ISO 3166-1 Alpha-2 standard
code_of_companystringCompany code
tax_numberstringTaxpayer number
site_urlstringWebsite URL
informing_purposestringPurpose of informing
descriptionstringService description

if the request is successful, you will receive a response:

  "data": {
    "id": 3152,
    "sender": "sender",
    "legal_name": "juridical_name",
    "address": "juridical_address",
    "status": "new",
    "type": "sms",
    "created_at": "2021-04-27 19:44:06",
    "country_code": "UA",
    "code_of_company": "string",
    "tax_number": "string",
    "site_url": "",
    "informing_purpose": "informing_purpose",
    "comment": "comment",
    "description": "description"