Supported Formats

json, csv

Examples

wget "https://[your-subdomain].trackdrive.net/api/v1/phone_numbers?number=+441224980000&auth_token=[your-auth-token]"

Response Example

{
  "status" : 200,
  "numbers" : [
    {
      "id" : 14812358,
      "created_at" : "2019-01-31T15:27:24.127+00:00",
      "updated_at" : "2019-01-31T15:27:24.127+00:00",
      "user_updated_at" : "2019-01-31T15:27:24.128+00:00",
      "name" : "+18443109569",
      "number" : "+18443109569",
      "offer_id" : 10007440,
      "traffic_source_id" : null,
      "provider_configuration_id" : 3686,
      "ring_pool_id" : 10002031,
      "provider_auth_key" : null,
      "last_call_at" : "2019-08-11T20:58:00.000+00:00",
      "token_values" : [],
      "country" : "US",
      "area_code_id" : null,
      "optimizer_displayed_at" : null,
      "optimizer_tokens_changed_at" : "2343b57814187ed9af6b9cc2a39f95ee",
      "plain_number" : "+18443109569",
      "extension" : null,
      "checksum" : "94af29dd77247e821229bad84f05504b",
      "human_number" : "(844) 310-9569"
    },
    {
      "id" : 14812357,
      "created_at" : "2019-01-31T15:27:22.508+00:00",
      "updated_at" : "2019-01-31T15:27:22.508+00:00",
      "user_updated_at" : "2019-01-31T15:27:22.509+00:00",
      "name" : "+18449248591",
      "number" : "+18449248591",
      "offer_id" : 10007440,
      "traffic_source_id" : null,
      "provider_configuration_id" : 3686,
      "ring_pool_id" : 10002031,
      "provider_auth_key" : null,
      "last_call_at" : "2019-09-10T17:09:16.000+00:00",
      "token_values" : [],
      "country" : "US",
      "area_code_id" : null,
      "optimizer_displayed_at" : null,
      "optimizer_tokens_changed_at" : "8ce19583853510e26139115261e23e79",
      "plain_number" : "+18449248591",
      "extension" : null,
      "checksum" : "ec26c7e2d1ee4afbf9c4b62d64502395",
      "human_number" : "(844) 924-8591"
    }
  ],
  "metadata" : {
    "root" : "numbers",
    "page" : 1,
    "total_pages" : 11,
    "per_page" : 2,
    "total_count" : 21,
    "next_cursor" : 14812357
  }
}

Params

Param name
Description
auth_token
optional

Authorize requests using your token. Get it from your profile: trackdrive.net/profile/edit

  • Must be String

page
optional

Return the next page of results.

  • Must be a number.

per_page
optional

How many results to return per page. The default is 25.

  • Must be a number.

created_at_to
optional

Date formatted like 2016-01-01 12:25:15 -0500

  • Must be String

created_at_from
optional

Date formatted like 2016-01-01 12:25:15 -0500

  • Must be String

fulltext
optional

Search for any record that matches this text

  • Must be String

time_zone
optional

Date ranges will be parsed using this time zone.

columns
optional
Specify the columns you would like returned by the API for a given resource. Limiting the columns can significantly increase API response time since only the requested data will be processed. columns=uuid,number,created_at

Must be any combination of:

  • id
  • created_at
  • updated_at
  • user_updated_at
  • name
  • number
  • offer_id
  • traffic_source_id
  • provider_configuration_id
  • ring_pool_id
  • provider_auth_key
  • last_call_at
  • token_values
  • country
  • area_code_id
  • optimizer_displayed_at
  • optimizer_tokens_changed_at
  • plain_number
  • extension
  • checksum
  • human_number
  • Must be String

root
optional

Pass root=false to return results without a root node and metadata.
For example:
GET /api/v1/calls?root=false will return [call1, call2, call3]
While:
GET /api/v1/calls will return {calls: [call1, call2, call3], metadata: {}}

  • Must be a boolean value: 1, true, yes, on, 0, false, no, off

number
optional

The phone number.

  • Must be String

offer_id
optional

Refer to the offer api for details

  • Must be a decimal number.

traffic_source_id
optional

Refer to the traffic source api for details

  • Must be a decimal number.

provider_configuration_id
optional

Refer to the provider api for details

  • Must be a decimal number.

ring_pool_id
optional

Refer to the Number Pool api for details

  • Must be a decimal number.

last_call_at_to
optional

Date formatted like 2016-01-01 12:25:15 -0500

  • Must be String

last_call_at_from
optional

Date formatted like 2016-01-01 12:25:15 -0500

  • Must be String