Supported Formats

json, csv

Examples

wget "https://[your-subdomain].trackdrive.net/api/v1/calls?page=1&in_progress=true&order=created_at&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

cursor
optional

The API provides a technique called ‘cursoring’ to paginate large result sets. Cursoring separates results into pages (the size of which are defined by the per_page request parameter) and provides a means to move backwards and forwards through these pages. To retrieve cursored results, you initially pass a cursor with a value of -1 to the endpoint. By default, an API endpoint that supports cursoring will assume -1 was passed as cursor if you do not provide one. The response to a cursored request will contain metadata.next_cursor. The next_cursor is the cursor that you should send to the endpoint to receive the next batch of responses. You will know that you have requested the last available page of results when the API responds with a next_cursor = 0.

  • Must be a number.

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, International Date Line West, Midway Island, American Samoa, Hawaii, Alaska, Pacific Time (US & Canada), Tijuana, Mountain Time (US & Canada), Arizona, Chihuahua, Mazatlan, Central Time (US & Canada), Saskatchewan, Guadalajara, Mexico City, Monterrey, Central America, Eastern Time (US & Canada), Indiana (East), Bogota, Lima, Quito, Atlantic Time (Canada), Caracas, La Paz, Santiago, Newfoundland, Brasilia, Buenos Aires, Montevideo, Georgetown, Greenland, Mid-Atlantic, Azores, Cape Verde Is., Dublin, Edinburgh, Lisbon, London, Casablanca, Monrovia, UTC, Belgrade, Bratislava, Budapest, Ljubljana, Prague, Sarajevo, Skopje, Warsaw, Zagreb, Brussels, Copenhagen, Madrid, Paris, Amsterdam, Berlin, Bern, Zurich, Rome, Stockholm, Vienna, West Central Africa, Bucharest, Cairo, Helsinki, Kyiv, Riga, Sofia, Tallinn, Vilnius, Athens, Istanbul, Minsk, Jerusalem, Harare, Pretoria, Kaliningrad, Moscow, St. Petersburg, Volgograd, Samara, Kuwait, Riyadh, Nairobi, Baghdad, Tehran, Abu Dhabi, Muscat, Baku, Tbilisi, Yerevan, Kabul, Ekaterinburg, Islamabad, Karachi, Tashkent, Chennai, Kolkata, Mumbai, New Delhi, Kathmandu, Astana, Dhaka, Sri Jayawardenepura, Almaty, Novosibirsk, Rangoon, Bangkok, Hanoi, Jakarta, Krasnoyarsk, Beijing, Chongqing, Hong Kong, Urumqi, Kuala Lumpur, Singapore, Taipei, Perth, Irkutsk, Ulaanbaatar, Seoul, Osaka, Sapporo, Tokyo, Yakutsk, Darwin, Adelaide, Canberra, Melbourne, Sydney, Brisbane, Hobart, Vladivostok, Guam, Port Moresby, Magadan, Srednekolymsk, Solomon Is., New Caledonia, Fiji, Kamchatka, Marshall Is., Auckland, Wellington, Nuku'alofa, Tokelau Is., Chatham Is., Samoa.

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:

  • uuid
  • recording_url
  • number_called
  • connected_to
  • caller_number
  • offer
  • traffic_source
  • buyer
  • obfuscated_caller_number
  • caller_city
  • caller_country
  • token_values
  • total_duration
  • hold_duration
  • ivr_duration
  • attempted_duration
  • answered_duration
  • user_offer_id
  • user_traffic_source_id
  • user_buyer_id
  • sub_id
  • ring_pool_id
  • status
  • buyer_converted
  • buyer_repeat_caller
  • buyer_revenue
  • revenue
  • traffic_source_converted
  • traffic_source_repeat_caller
  • traffic_source_payout
  • payout
  • trackdrive_cost
  • provider_cost
  • hangup_reason
  • call_sid
  • provider
  • outgoing_webhooks_count
  • created_at
  • ended_at
  • 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

offer_repeat_caller
optional

Match calls where the Traffic Source had a repeat caller.

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

buyer_repeat_caller
optional

Match calls where the Buyer had a repeat caller.

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

buyer_converted
optional

Did the buyer convert?

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

offer_converted
optional

Did the traffic source convert?

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

in_progress
optional

Match calls that are on-going

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

placed_on_hold
optional

Was the call placed on hold?

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

has_recording
optional

Match calls that have a recording.

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

either_converted
optional

Whether this call's buyer or traffic source has converted.

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

buyer_conversion_duplicated_call
optional

Match calls where the callerID was a duplicate against the Buyer's conversion settings.

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

offer_conversion_duplicated_call
optional

Match calls where the callerID was a duplicate against the Traffic Source's conversion settings.

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

no_buyer
optional

Match calls that didn't connect to a Buyer

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

token_key
optional

Calls that are tagged with this token will be matched. EG: token_key=buyer_id will return all calls that have a buyer_id token.

  • Must be String

token_value
optional

Will match calls that are tagged with a token:value. EG: token_key=buyer_id:12345 will return all calls that have a buyer_id token with the value set to 12345.

  • Must be String

order
optional

Sort results by this field.

  • Must be one of: direction, number_id, offer_id, traffic_source_id, sub_id, buyer_id, caller_number, updated_at, total_duration, hold_duration, ivr_duration, cost, charge, answered_duration, status, sub_status, buyer_converted, revenue, offer_converted, payout, outgoing_webhooks_count, created_at, end_time, lead_id.

order_dir
optional

Sort results in ascending or descending order.

  • Must be one of: desc, asc.

number_id
optional

Refer to the number api for details

  • Must be a decimal number.

offer_id
optional

Refer to the offer api for details

  • Must be a decimal number.

schedule_id
optional

Schedule internal id.

  • Must be a decimal number.

traffic_source_id
optional

Refer to the traffic source api for details

  • Must be a decimal number.

buyer_id
optional

Refer to the buyer api for details

  • Must be a decimal number.

buyer_group_ids
optional

Buyer Group Internal ids.

  • Must be a decimal number.

ring_pool_id
optional

Refer to the Number Pool api for details

  • Must be a decimal number.

id
optional

An Integer number eg: 12345

  • Must be a decimal number.

provider_configuration_id
optional

Refer to the provider api for details

  • Must be a decimal number.

contact_id
optional

Match calls that were placed by this caller.

  • Must be a decimal number.

status
optional

Match results that have this status.

  • Must be one of: forwarded, finished, on-hold, no-answer, no-buyer, no-buyer-all-maxed-out, no-buyer-all-filtered, no-buyer-prevent-dupes, not-open, caller-hung-up, rejected, rejected-traffic-source-capped-hang-up, rejected-no-concurrency-cap-available, no-answer-convert-on-attempt, rejected-caller-concurrency-exceeded, rejected-average-hold-time-exceeded, blocked, failed, hold-queue-waited-too-long.

ended_at_to
optional

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

  • Must be String

ended_at_from
optional

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

  • Must be String


GET /api/v1/calls/reports
Get statistics on calls by category.

Supported Formats

json, csv

Examples

wget "https://[your-subdomain].trackdrive.net/api/v1/calls/reports?category=buyer_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

category
required
  • Must be one of: buyer_id, offer_id, traffic_source_id, number_id, status, direction, sub_status, provider_configuration_id, contact_id, placed_on_hold, ring_pool_id, contact_state, contact_country, buyer_converted, offer_converted, in_progress.

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, International Date Line West, Midway Island, American Samoa, Hawaii, Alaska, Pacific Time (US & Canada), Tijuana, Mountain Time (US & Canada), Arizona, Chihuahua, Mazatlan, Central Time (US & Canada), Saskatchewan, Guadalajara, Mexico City, Monterrey, Central America, Eastern Time (US & Canada), Indiana (East), Bogota, Lima, Quito, Atlantic Time (Canada), Caracas, La Paz, Santiago, Newfoundland, Brasilia, Buenos Aires, Montevideo, Georgetown, Greenland, Mid-Atlantic, Azores, Cape Verde Is., Dublin, Edinburgh, Lisbon, London, Casablanca, Monrovia, UTC, Belgrade, Bratislava, Budapest, Ljubljana, Prague, Sarajevo, Skopje, Warsaw, Zagreb, Brussels, Copenhagen, Madrid, Paris, Amsterdam, Berlin, Bern, Zurich, Rome, Stockholm, Vienna, West Central Africa, Bucharest, Cairo, Helsinki, Kyiv, Riga, Sofia, Tallinn, Vilnius, Athens, Istanbul, Minsk, Jerusalem, Harare, Pretoria, Kaliningrad, Moscow, St. Petersburg, Volgograd, Samara, Kuwait, Riyadh, Nairobi, Baghdad, Tehran, Abu Dhabi, Muscat, Baku, Tbilisi, Yerevan, Kabul, Ekaterinburg, Islamabad, Karachi, Tashkent, Chennai, Kolkata, Mumbai, New Delhi, Kathmandu, Astana, Dhaka, Sri Jayawardenepura, Almaty, Novosibirsk, Rangoon, Bangkok, Hanoi, Jakarta, Krasnoyarsk, Beijing, Chongqing, Hong Kong, Urumqi, Kuala Lumpur, Singapore, Taipei, Perth, Irkutsk, Ulaanbaatar, Seoul, Osaka, Sapporo, Tokyo, Yakutsk, Darwin, Adelaide, Canberra, Melbourne, Sydney, Brisbane, Hobart, Vladivostok, Guam, Port Moresby, Magadan, Srednekolymsk, Solomon Is., New Caledonia, Fiji, Kamchatka, Marshall Is., Auckland, Wellington, Nuku'alofa, Tokelau Is., Chatham Is., Samoa.

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:

  • uuid
  • recording_url
  • number_called
  • connected_to
  • caller_number
  • offer
  • traffic_source
  • buyer
  • obfuscated_caller_number
  • caller_city
  • caller_country
  • token_values
  • total_duration
  • hold_duration
  • ivr_duration
  • attempted_duration
  • answered_duration
  • user_offer_id
  • user_traffic_source_id
  • user_buyer_id
  • sub_id
  • ring_pool_id
  • status
  • buyer_converted
  • buyer_repeat_caller
  • buyer_revenue
  • revenue
  • traffic_source_converted
  • traffic_source_repeat_caller
  • traffic_source_payout
  • payout
  • trackdrive_cost
  • provider_cost
  • hangup_reason
  • call_sid
  • provider
  • outgoing_webhooks_count
  • created_at
  • ended_at
  • 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

offer_repeat_caller
optional

Match calls where the Traffic Source had a repeat caller.

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

buyer_repeat_caller
optional

Match calls where the Buyer had a repeat caller.

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

buyer_converted
optional

Did the buyer convert?

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

offer_converted
optional

Did the traffic source convert?

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

in_progress
optional

Match calls that are on-going

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

placed_on_hold
optional

Was the call placed on hold?

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

has_recording
optional

Match calls that have a recording.

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

either_converted
optional

Whether this call's buyer or traffic source has converted.

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

buyer_conversion_duplicated_call
optional

Match calls where the callerID was a duplicate against the Buyer's conversion settings.

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

offer_conversion_duplicated_call
optional

Match calls where the callerID was a duplicate against the Traffic Source's conversion settings.

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

no_buyer
optional

Match calls that didn't connect to a Buyer

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

token_key
optional

Calls that are tagged with this token will be matched. EG: token_key=buyer_id will return all calls that have a buyer_id token.

  • Must be String

token_value
optional

Will match calls that are tagged with a token:value. EG: token_key=buyer_id:12345 will return all calls that have a buyer_id token with the value set to 12345.

  • Must be String

order
optional

Sort results by this field.

  • Must be one of: direction, number_id, offer_id, traffic_source_id, sub_id, buyer_id, caller_number, updated_at, total_duration, hold_duration, ivr_duration, cost, charge, answered_duration, status, sub_status, buyer_converted, revenue, offer_converted, payout, outgoing_webhooks_count, created_at, end_time, lead_id.

order_dir
optional

Sort results in ascending or descending order.

  • Must be one of: desc, asc.

number_id
optional

Refer to the number api for details

  • Must be a decimal number.

offer_id
optional

Refer to the offer api for details

  • Must be a decimal number.

schedule_id
optional

Schedule internal id.

  • Must be a decimal number.

traffic_source_id
optional

Refer to the traffic source api for details

  • Must be a decimal number.

buyer_id
optional

Refer to the buyer api for details

  • Must be a decimal number.

buyer_group_ids
optional

Buyer Group Internal ids.

  • Must be a decimal number.

ring_pool_id
optional

Refer to the Number Pool api for details

  • Must be a decimal number.

id
optional

An Integer number eg: 12345

  • Must be a decimal number.

provider_configuration_id
optional

Refer to the provider api for details

  • Must be a decimal number.

contact_id
optional

Match calls that were placed by this caller.

  • Must be a decimal number.

status
optional

Match results that have this status.

  • Must be one of: forwarded, finished, on-hold, no-answer, no-buyer, no-buyer-all-maxed-out, no-buyer-all-filtered, no-buyer-prevent-dupes, not-open, caller-hung-up, rejected, rejected-traffic-source-capped-hang-up, rejected-no-concurrency-cap-available, no-answer-convert-on-attempt, rejected-caller-concurrency-exceeded, rejected-average-hold-time-exceeded, blocked, failed, hold-queue-waited-too-long.

ended_at_to
optional

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

  • Must be String

ended_at_from
optional

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

  • Must be String


GET /api/v1/calls/stats
Get statistics on calls by category and interval.

Supported Formats

json

Examples

wget "https://[your-subdomain].trackdrive.net/api/v1/calls/stats/?group_by=status&created_at_from=2019-03-19 02:49:54 UTC&created_at_to=2019-03-19 14:49:54 +0000&stat=count&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

group_by
required

Group calls by one of these attributes.

  • Must be one of: buyer_converted, offer_converted, status, created_at_five_minutes, created_at_twenty_minutes, created_at_hour, created_at_day, created_at_week, created_at_month.

stat
required

Return statistics on the grouped calls by one of these numeric columns.

  • Must be one of: count, revenue, profit, cost.

created_at_to
required

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

  • Must be String

created_at_from
required

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

  • Must be String

page
optional

Return the next page of results.

  • Must be a number.

offer_repeat_caller
optional

Match calls where the Traffic Source had a repeat caller.

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

buyer_repeat_caller
optional

Match calls where the Buyer had a repeat caller.

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

buyer_converted
optional

Did the buyer convert?

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

offer_converted
optional

Did the traffic source convert?

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

in_progress
optional

Match calls that are on-going

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

placed_on_hold
optional

Was the call placed on hold?

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

has_recording
optional

Match calls that have a recording.

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

either_converted
optional

Whether this call's buyer or traffic source has converted.

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

buyer_conversion_duplicated_call
optional

Match calls where the callerID was a duplicate against the Buyer's conversion settings.

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

offer_conversion_duplicated_call
optional

Match calls where the callerID was a duplicate against the Traffic Source's conversion settings.

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

no_buyer
optional

Match calls that didn't connect to a Buyer

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

token_key
optional

Calls that are tagged with this token will be matched. EG: token_key=buyer_id will return all calls that have a buyer_id token.

  • Must be String

token_value
optional

Will match calls that are tagged with a token:value. EG: token_key=buyer_id:12345 will return all calls that have a buyer_id token with the value set to 12345.

  • Must be String

order
optional

Sort results by this field.

  • Must be one of: direction, number_id, offer_id, traffic_source_id, sub_id, buyer_id, caller_number, updated_at, total_duration, hold_duration, ivr_duration, cost, charge, answered_duration, status, sub_status, buyer_converted, revenue, offer_converted, payout, outgoing_webhooks_count, created_at, end_time, lead_id.

order_dir
optional

Sort results in ascending or descending order.

  • Must be one of: desc, asc.

number_id
optional

Refer to the number api for details

  • Must be a decimal number.

offer_id
optional

Refer to the offer api for details

  • Must be a decimal number.

schedule_id
optional

Schedule internal id.

  • Must be a decimal number.

traffic_source_id
optional

Refer to the traffic source api for details

  • Must be a decimal number.

buyer_id
optional

Refer to the buyer api for details

  • Must be a decimal number.

buyer_group_ids
optional

Buyer Group Internal ids.

  • Must be a decimal number.

ring_pool_id
optional

Refer to the Number Pool api for details

  • Must be a decimal number.

id
optional

An Integer number eg: 12345

  • Must be a decimal number.

provider_configuration_id
optional

Refer to the provider api for details

  • Must be a decimal number.

contact_id
optional

Match calls that were placed by this caller.

  • Must be a decimal number.

status
optional

Match results that have this status.

  • Must be one of: forwarded, finished, on-hold, no-answer, no-buyer, no-buyer-all-maxed-out, no-buyer-all-filtered, no-buyer-prevent-dupes, not-open, caller-hung-up, rejected, rejected-traffic-source-capped-hang-up, rejected-no-concurrency-cap-available, no-answer-convert-on-attempt, rejected-caller-concurrency-exceeded, rejected-average-hold-time-exceeded, blocked, failed, hold-queue-waited-too-long.

ended_at_to
optional

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

  • Must be String

ended_at_from
optional

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

  • Must be String


GET /api/v1/calls/:id
Get a call by id or uuid.

Examples

wget "https://[your-subdomain].trackdrive.net/api/v1/calls/5cc8897c-ad0f-44cb-8ea7-8f7736ae76f1?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

id
optional

Find the call by ID or UUID.
Example ID 123895022.
Example UUID c3b20b12-3b3b-4322-b15d-0f1c5f653479

  • Must be String


PUT /api/v1/calls/:id
Update a call with post_call_tokens.

Examples

curl -H "Content-Type: application/json" -X PUT -d '{"post_call_tokens": {"good_lead":"yes","loan_amount":"500"}}' https://[your-subdomain].trackdrive.net/api/v1/calls/: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

id
optional

Find the call by ID or UUID.
Example ID 123895022.
Example UUID c3b20b12-3b3b-4322-b15d-0f1c5f653479

  • Must be String

post_call_tokens
optional

Custom contact fields defined on the offer.
EG: {first_name: "John", last_name: "Smith", zip_code: "90210"}

  • Must be Hash

revenue
optional

The revenue paid out for the call.

  • Must be a decimal number.

buyer_converted
optional

Did the buyer convert?

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

payout
optional

The amount paid to thetraffic source.

  • Must be a decimal number.

offer_converted
optional

Did the traffic source convert?

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


POST /api/v1/calls/update_buyer/:caller_id
Update a call's revenue and buyer_converted using the call's caller_id and offer_token

Examples

curl -H "Content-Type: application/json" -X POST -d '{"add_revenue": 2.50, "buyer_converted": "true"}' https://[your-subdomain].trackdrive.net/api/v1/calls/update_buyer/:caller_id?auth_token=[your-auth-token]
curl -X POST "https://my-company.trackdrive.net/api/v1/calls/update_buyer/17194448888?auth_token=my-user-token&offer_token=the-offer-token&add_revenue=5"

Params

Param name
Description
auth_token
optional

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

  • Must be String

caller_id
required

The caller ID for the call that will be updated.

  • Must be String

offer_token
required

The Dynamic Number Insertion token for the offer.

  • Must be String

call_timeframe
optional

Pass this optional parameter to restrict the call update to calls made in the last call_timeframe minutes. For Example: Pass 120 if you'd like to only update calls made in the last 2 hours. This is useful if you only want to update a call that happened recently.

  • Must be a number.

revenue
optional

Set the call's revenue to this amount. For example pass 10.50 to set the revenue to 10.50

  • Must be a decimal number.

add_revenue
optional

Add this amount to the call's current revenue. For example pass 2.5 to add 2.5 to the current call revenue. If the call revenue is currently 10.50, the revenue would become 13 (10.50 + 2.50)

  • Must be a decimal number.

buyer_converted
optional

Did the buyer convert?

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


DELETE /api/v1/calls/:id
Hang up an ongoing call.

Examples

curl -i -X DELETE "https://[your-subdomain].trackdrive.net/api/v1/calls/77777777-dbe3-49ee-b28f-115ec80dcef9?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

id
optional

Find the call by ID or UUID.
Example ID 123895022.
Example UUID c3b20b12-3b3b-4322-b15d-0f1c5f653479

  • Must be String