List 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
  }
}

GET

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 only request-owned fields. It does not include businessProfileId, provider object ids, private attachment paths, or 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

string

Number request id.

string

Brand name.

string

Request-owned registered legal name.

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

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

Safe rejection reason when present.

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.

API Reference

V2 API Reference

Partner Accounts (v2)

Messages (v2)

Contacts (v2)

Lists (v2)

Number Requests (v2)

Business Profiles (v2)

Creatives (v2)

Audiences (v2)

Offers (v2)

Schedules (v2)

Revenue (v2)

Usage & Billing (v2)

Data Import (v2)

Links (v2)

Clicks (v2)

Webhooks (v2)

Phone Validation (v1)

API Reference (v1 - Deprecated)

Query parameters

Response

Example

Error codes

Next steps

Get Number Request

Create Number Request

​Query parameters

​Response

​Example

​Error codes

​Next steps

Get Number Request

Create Number Request

Query parameters

Response

Example

Error codes

Next steps