GET /api/v1/phone_numbers
Get the phone numbers assigned to your account.

Supported Formats

json, csv

Examples

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

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.

  • Must be one of: Etc/UTC, UTC, SST, HST, AKST, PST, MST, CST, EST, COT, PET, AST, VET, BOT, CLST, NST, BRST, ART, UYT, GYT, WGT, GST, AZOT, CVT, GMT, WET, CET, EET, MSK, IST, CAT, SAST, EAT, IRST, AZT, GET, AMT, AFT, YEKT, PKT, UZT, NPT, BDT, NOVT, MMT, ICT, WIB, KRAT, HKT, XJT, MYT, SGT, AWST, IRKT, ULAT, KST, JST, YAKT, ACST, ACDT, AEDT, AEST, VLAT, ChST, PGT, MAGT, SBT, NCT, FJST, PETT, MHT, NZDT, TOT, TKT, CHADT, WSDT.

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
  • number
  • offer_id
  • traffic_source_id
  • provider_configuration_id
  • sub_id
  • ring_pool_id
  • provider_auth_key
  • last_call_at
  • created_at
  • updated_at
  • Must be String

number
optional

The phone number.

  • Must be String

offer_id
optional

Refer to the offer api for details

  • Must be a number.

traffic_source_id
optional

Refer to the traffic source api for details

  • Must be a number.

provider_configuration_id
optional

Refer to the provider api for details

  • Must be a number.

ring_pool_id
optional

Refer to the ring pool api for details

  • Must be a 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


POST /api/v1/phone_numbers
Purchase a new phone number using one of your existing provider configurations.

Supported Formats

json

Examples

curl -H "Content-Type: application/json" -X POST -d '{provider_configuration_id: 150, offer_id: 100, toll_free: true, country: 'US'}' https://[your-subdomain].trackdrive.net/api/v1/phone_numbers.json?auth_token=[your-auth-token]

Params

Param name
Description
auth_token
optional

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

  • Must be String

provider_configuration_id
required

Refer to the provider api for details

  • Must be a number.

offer_id
required

Refer to the offer api for details

  • Must be a number.

toll_free
required

Purchase a toll-free or local number? true for toll-free, false for local number.

  • Must be one of: true, false.

country
required

The country where the number will be purchased.

  • Must be one of: AR, AT, AU, BE, BG, BH, BR, CA, CH, CL, CN, CO, CY, CZ, DE, DK, DO, EE, ES, FI, FR, GB, GE, GR, HK, HR, HU, ID, IE, IL, IT, JP, KR, LT, LU, LV, MT, MX, MY, NL, NO, NZ, PA, PE, PH, PK, PL, PR, PT, RO, RU, SE, SG, SI, SK, SV, TR, US, ZA.

traffic_source_id
optional

Refer to the traffic source api for details

  • Must be a number.

ring_pool_id
optional

Refer to the ring pool api for details

  • Must be a number.


DELETE /api/v1/phone_numbers/:id
Unrent a phone number.

Supported Formats

json

Examples

curl -H "Content-Type: application/json" -X DELETE https://[your-subdomain].trackdrive.net/api/v1/phone_numbers/:id?auth_token=[your-auth-token]

Params

Param name
Description
auth_token
optional

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

  • Must be String