import requests
response = requests.get(
"https://api.tracklysms.com/api/v2/number-requests",
headers={"X-Api-Key": "trk_your_api_key_here"},
)
{
"requests": [
{
"id": "665f0a1b2c3d4e5f60718293",
"brandName": "Acme Co",
"companyLegalName": "Acme Incorporated",
"listName": "Acme Alerts",
"phoneNumberType": "toll_free",
"targetCountries": ["CA"],
"addressCountry": "GB",
"identifierType": "vat",
"status": "pending",
"provisioningStatus": "not_started",
"internationalAcquisitionStatus": "PENDING_REVIEW",
"createdAt": "2026-08-03T22:00:00",
"updatedAt": "2026-08-03T22:05:00"
}
],
"pagination": {
"page": 1,
"per_page": 50,
"total": 1,
"total_pages": 1
}
}
Number Requests (v2)
List Number Requests
Retrieve account-owned number provisioning requests, newest first.
GET
/
v2
/
number-requests
import requests
response = requests.get(
"https://api.tracklysms.com/api/v2/number-requests",
headers={"X-Api-Key": "trk_your_api_key_here"},
)
{
"requests": [
{
"id": "665f0a1b2c3d4e5f60718293",
"brandName": "Acme Co",
"companyLegalName": "Acme Incorporated",
"listName": "Acme Alerts",
"phoneNumberType": "toll_free",
"targetCountries": ["CA"],
"addressCountry": "GB",
"identifierType": "vat",
"status": "pending",
"provisioningStatus": "not_started",
"internationalAcquisitionStatus": "PENDING_REVIEW",
"createdAt": "2026-08-03T22:00:00",
"updatedAt": "2026-08-03T22:05:00"
}
],
"pagination": {
"page": 1,
"per_page": 50,
"total": 1,
"total_pages": 1
}
}
Returns number requests for the API-key account, ordered newest first and paginated. Read operations work with live and sandbox keys.
The response contains request-owned fields and a safe
businessVerification summary. It omits provider object ids, private attachment paths, and the carrier identifier value in taxId.
Query parameters
integer
default:"1"
Page number.
integer
default:"50"
Items per page, from 1 through 100.
Response
object
Contains
page, per_page, total, and total_pages.array
Account-owned number request objects.
Show Number request fields
Show Number request fields
string
Number request id.
string
Brand name.
string
Request-owned registered legal name.
object
Contains
profileId, status, identityRevision, relationship, ready, code, message, and confirmationRequired. Use the code and message to resume verification; readiness is rechecked when submitting or calling the provider.string
Sending list name.
string
toll_free or 10dlc.string
Messaging use case.
string
TCR vertical when present.
array
Exactly one number country for new requests.
string
Business website.
string
Customer-hosted opt-in URL.
string
Terms and Conditions URL when supplied.
string
Request-owned privacy policy URL.
string
Carrier support email.
string
Carrier support phone.
string
Authorized carrier contact first name.
string
Authorized carrier contact last name.
string
Business industry.
string
Business street.
string
Business city.
string
Business state or province.
string
Business postal code.
string
Business address country that selected the carrier identifier.
string
Canonical request identifier type. The identifier value is not returned.
string
Estimated monthly segment volume.
string
Request lifecycle status, such as
draft, pending, approved, or rejected.string
Provider provisioning status:
not_started, in_progress, completed, or failed.string
Provisioned E.164 number when available.
string
USA carrier campaign stage when applicable.
string
Rejection note written by an admin reviewer and returned verbatim when present, not a sanitized field.
string
Resource Request status for CA or another non-US target.
object
Safe provider feedback keyed by requirement.
object
Persisted request-owned dynamic form values.
array
Request-owned document metadata. Private paths and provider document ids are omitted.
datetime
Creation timestamp.
datetime
Last update timestamp.
Example
import requests
response = requests.get(
"https://api.tracklysms.com/api/v2/number-requests",
headers={"X-Api-Key": "trk_your_api_key_here"},
)
{
"requests": [
{
"id": "665f0a1b2c3d4e5f60718293",
"brandName": "Acme Co",
"companyLegalName": "Acme Incorporated",
"listName": "Acme Alerts",
"phoneNumberType": "toll_free",
"targetCountries": ["CA"],
"addressCountry": "GB",
"identifierType": "vat",
"status": "pending",
"provisioningStatus": "not_started",
"internationalAcquisitionStatus": "PENDING_REVIEW",
"createdAt": "2026-08-03T22:00:00",
"updatedAt": "2026-08-03T22:05:00"
}
],
"pagination": {
"page": 1,
"per_page": 50,
"total": 1,
"total_pages": 1
}
}
Error codes
| HTTP | Code | Meaning |
|---|---|---|
| 401 | invalid_credentials | API key is missing or invalid. |
| 403 | account_suspended | Account access is suspended. |
Next steps
Get Number Request
Read one request
Create Number Request
Submit a new request-owned identity