API documentation

GET /phone_numbers/search

Authorization Required

https://[your-subdomain].trackdrive.com/api/v1/phone_numbers/search

Search available phone numbers for purchase

Returns a list of available phone numbers for sale. Can be used with POST /api/v1/phone_numbers?requested_number= to purchase a number.

Params

Param name	Description
country Optional	Two-letter country code (default: US) Must be a String
toll_free Optional	Whether to search toll-free numbers Must be one of: `true`, `false`.
prefix Optional	Restrict by area code (NPA). Example: 415, 209, 719 Must be a String
query Optional	Full or partial phone number to match Must be a String

Example Request

curl 'https://[your-subdomain].trackdrive.com/api/v1/phone_numbers/search?prefix=415&toll_free=false' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY'

Example Response 200

{
  "status": 200,
  "success": true,
  "phone_number_search_results": [
    {
      "id": "+14154151864",
      "type": "PhoneNumberSearchResult",
      "phone_number": "+14154151864",
      "country": "US",
      "toll_free": false,
      "prefix": "415"
    },
    {
      "id": "+14154471210",
      "type": "PhoneNumberSearchResult",
      "phone_number": "+14154471210",
      "country": "US",
      "toll_free": false,
      "prefix": "415"
    },
    {
      "id": "+14155297950",
      "type": "PhoneNumberSearchResult",
      "phone_number": "+14155297950",
      "country": "US",
      "toll_free": false,
      "prefix": "415"
    },
    {
      "id": "+14155868810",
      "type": "PhoneNumberSearchResult",
      "phone_number": "+14155868810",
      "country": "US",
      "toll_free": false,
      "prefix": "415"
    },
    {
      "id": "+14156952675",
      "type": "PhoneNumberSearchResult",
      "phone_number": "+14156952675",
      "country": "US",
      "toll_free": false,
      "prefix": "415"
    },
    {
      "id": "+14156978735",
      "type": "PhoneNumberSearchResult",
      "phone_number": "+14156978735",
      "country": "US",
      "toll_free": false,
      "prefix": "415"
    },
    {
      "id": "+14158677640",
      "type": "PhoneNumberSearchResult",
      "phone_number": "+14158677640",
      "country": "US",
      "toll_free": false,
      "prefix": "415"
    },
    {
      "id": "+14158817332",
      "type": "PhoneNumberSearchResult",
      "phone_number": "+14158817332",
      "country": "US",
      "toll_free": false,
      "prefix": "415"
    },
    {
      "id": "+14159259977",
      "type": "PhoneNumberSearchResult",
      "phone_number": "+14159259977",
      "country": "US",
      "toll_free": false,
      "prefix": "415"
    },
    {
      "id": "+14159415711",
      "type": "PhoneNumberSearchResult",
      "phone_number": "+14159415711",
      "country": "US",
      "toll_free": false,
      "prefix": "415"
    }
  ],
  "metadata": {
    "root": "phone_number_search_results",
    "page": 1,
    "total_pages": 0,
    "per_page": 25,
    "total_count": 10,
    "next_cursor": 0.0
  }
}