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:

POST  http://one-api.bsg.world/api/senders/requests/legal

Request parameters:

ParameterRequiredTypeDefaultDescription
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.
commentNostringNoComment.
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": "https://dev-app.bsg.world/",
  "comment": "comm",
  "legal_name": "juridical_name",
  "address": "juridical_address"
}

Response parameters:

ParameterTypeDescription
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
commentstringComment
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": "https://dev-app.bsg.world",
    "informing_purpose": "informing_purpose",
    "comment": "comment",
    "description": "description"
  }
}

We use cookies (and other similar technologies) to collect data to improve your experience on our site. By using our website, you’re agreeing to the collection of data as described in our Website Data Collection Policy.