import requests
response = requests.get(
"https://api.tracklysms.com/api/v2/number-requests/665f0a1b2c3d4e5f60718293",
headers={"X-Api-Key": "trk_your_api_key_here"},
)
{
"request": {
"id": "665f0a1b2c3d4e5f60718293",
"brandName": "Acme Co",
"companyLegalName": "Acme Incorporated",
"listName": "Acme Alerts",
"phoneNumberType": "toll_free",
"targetCountries": ["CA"],
"addressCountry": "GB",
"identifierType": "vat",
"status": "approved",
"provisioningStatus": "in_progress",
"provisionedPhoneNumber": null,
"internationalAcquisitionStatus": "PENDING_REVIEW",
"internationalAcquisitionFeedback": {},
"internationalAcquisitionFormData": {
"companyName": "Acme Incorporated"
},
"internationalAcquisitionDocuments": [],
"createdAt": "2026-08-03T22:00:00",
"updatedAt": "2026-08-03T22:05:00"
}
}
{
"error": "not_found",
"message": "Number request not found"
}
Number Requests (v2)
Get Number Request
Retrieve one account-owned number request and its current provisioning state.
GET
/
v2
/
number-requests
/
{request_id}
import requests
response = requests.get(
"https://api.tracklysms.com/api/v2/number-requests/665f0a1b2c3d4e5f60718293",
headers={"X-Api-Key": "trk_your_api_key_here"},
)
{
"request": {
"id": "665f0a1b2c3d4e5f60718293",
"brandName": "Acme Co",
"companyLegalName": "Acme Incorporated",
"listName": "Acme Alerts",
"phoneNumberType": "toll_free",
"targetCountries": ["CA"],
"addressCountry": "GB",
"identifierType": "vat",
"status": "approved",
"provisioningStatus": "in_progress",
"provisionedPhoneNumber": null,
"internationalAcquisitionStatus": "PENDING_REVIEW",
"internationalAcquisitionFeedback": {},
"internationalAcquisitionFormData": {
"companyName": "Acme Incorporated"
},
"internationalAcquisitionDocuments": [],
"createdAt": "2026-08-03T22:00:00",
"updatedAt": "2026-08-03T22:05:00"
}
}
{
"error": "not_found",
"message": "Number request not found"
}
Returns one number request owned by the API-key account. A request from another tenant returns the same
Use Get International Requirements for the current provider requirement schema, saved form values, request-owned document metadata, and requirement feedback.
Use Get Registration Readiness for asynchronous submission and public-evidence findings. Business verification, readiness, and carrier approval are separate decisions.
404 not_found response as an unknown id.
The response contains request-owned identity, contact, address, routing, and safe acquisition state. Its businessVerification object identifies the explicitly bound business and reports current readiness, revision, and recovery guidance. It omits taxId, provider request ids, provider document ids, and private attachment paths.
Path parameters
string
required
Number request id.
Response
object
Number request object. See List Number Requests for the complete field reference.
Example
import requests
response = requests.get(
"https://api.tracklysms.com/api/v2/number-requests/665f0a1b2c3d4e5f60718293",
headers={"X-Api-Key": "trk_your_api_key_here"},
)
{
"request": {
"id": "665f0a1b2c3d4e5f60718293",
"brandName": "Acme Co",
"companyLegalName": "Acme Incorporated",
"listName": "Acme Alerts",
"phoneNumberType": "toll_free",
"targetCountries": ["CA"],
"addressCountry": "GB",
"identifierType": "vat",
"status": "approved",
"provisioningStatus": "in_progress",
"provisionedPhoneNumber": null,
"internationalAcquisitionStatus": "PENDING_REVIEW",
"internationalAcquisitionFeedback": {},
"internationalAcquisitionFormData": {
"companyName": "Acme Incorporated"
},
"internationalAcquisitionDocuments": [],
"createdAt": "2026-08-03T22:00:00",
"updatedAt": "2026-08-03T22:05:00"
}
}
{
"error": "not_found",
"message": "Number request not found"
}
Error codes
| HTTP | Code | Meaning |
|---|---|---|
| 401 | invalid_credentials | API key is missing or invalid. |
| 404 | not_found | No request with this id exists for the API-key account. |
Next steps
Update Number Request
Correct request-owned identity while editable
Get Requirements
Read non-US form and document state