SMS Sender Registration
Submit a registration request for an alphanumeric SMS sender in one or more countries.
POST
/api/v1/{account_code}/sms/senders/registration-requests/
Authorization
Bearer {token} — 56 characters
Submits a sender registration request for each country specified in country_codes.
The response contains one record per country, each with its own approval status.
Manual review required
Sender registration requests are subject to manual review.
The
translated_status field reflects the current state:
Submitted, Approved, or Rejected.
Parameters (JSON)
| Parameter | Required | Type | Description / Example |
|---|---|---|---|
| account_code | YES | string (UUID) | Account code XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX — passed in the URL path |
| country_codes | YES | array<string> | ISO country codes (e.g. ["IT", "ES"]) |
| sender | YES | string (max 11) / numeric (max 16) | Sender name to register (e.g. "MySender") |
| data | YES | object | Company/applicant details — see fields below |
data Object
| Field | Required | Type | Description |
|---|---|---|---|
| name | YES | string | Company name (e.g. "Company Ltd") |
| vat | YES | string | Valid VAT / tax ID number |
| address | YES | string | Full address (street, postal code, city, region, country) |
| YES | string | Valid contact email address | |
| pec | NO | string | Certified email address (PEC — Italy specific) |
| phone | YES | string | Phone number with international prefix (e.g. "+390612345678") |
Example Request
JSON
{
"country_codes": ["IT", "ES"],
"sender": "MySender",
"data": {
"name": "Company Ltd",
"vat": "IT12345678901",
"address": "1 Example Street, 00042, Rome, RM, Italy",
"email": "info@example.com",
"pec": "info@pec.example.com",
"phone": "+390612345678"
}
}Success Response
200 OK
An array with one object per requested country in country_codes.
JSON
[
{
"status": 0,
"translated_status": "Submitted",
"sender": "MySender",
"country_code": "IT",
"data": {
"name": "Company Ltd",
"vat": "IT12345678901",
"address": "1 Example Street, 00042, Rome, RM, Italy",
"email": "info@example.com",
"pec": "info@pec.example.com",
"phone": "+390612345678"
},
"rejection_reason": null,
"created": "2025-01-07T17:29:50.500720+01:00",
"modified": "2025-01-07T17:29:50.500720+01:00"
},
{
"status": 0,
"translated_status": "Submitted",
"sender": "MySender",
"country_code": "ES",
"data": {
"name": "Company Ltd",
"vat": "IT12345678901",
"address": "1 Example Street, 00042, Rome, RM, Italy",
"email": "info@example.com",
"pec": "info@pec.example.com",
"phone": "+390612345678"
},
"rejection_reason": null,
"created": "2025-01-07T17:29:50.500720+01:00",
"modified": "2025-01-07T17:29:50.500720+01:00"
}
]Response Fields
| Field | Type | Description |
|---|---|---|
| status | integer | Numeric status code of the request |
| translated_status | string | Human-readable status: Submitted, Approved, Rejected |
| sender | string | Requested sender name |
| country_code | string | ISO country code for this entry |
| data | object | Company data submitted |
| rejection_reason | string|null | Rejection reason (present only if Rejected) |
| created | string | Creation timestamp (ISO 8601) |
| modified | string | Last modified timestamp (ISO 8601) |