GET /api/v1/offers
List Offer records.

Supported Formats

json, csv

Examples

curl -H "Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY" "https://[your-subdomain].trackdrive.com/api/v1/offers?page=1&order=created_at"

Params

Param name
Description
serializer
Optional Blank Value Allowed

This endpoint supports multiple response formats. Pass serializer=name to retrieve data in an alternate format.

  • Must be a value contained in the pick list:
    Acceptable ValueDescription
    offerDefault response format.
    offer_gridModern response format that returns various foreign keys for use with other API endpoints.
page
Optional

Return the next page of results.

  • 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

order
Optional

Sort results by this field.

  • Must be one of: name, schedules_count, numbers_count, buyers_count, agents_count, paused, user_offer_id, calls_count, recent_calls_count, last_call_at, numbers_count, created_at.

order_dir
Optional

Sort results in ascending or descending order.

  • Must be one of: asc, desc.

fulltext
Optional

Search for any record that matches this text

  • Must be String

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
  • legacy_id
  • type
  • uuid
  • created_at
  • updated_at
  • deleted_at
  • user_updated_at
  • routes_show_path
  • routes_edit_path
  • external_record_id
  • user_offer_id
  • paused
  • numbers_api_key
  • leads_api_key
  • name
  • numbers_count
  • max_cc_count
  • active_cc_count
  • in_progress_count
  • call_routers_attributes
  • lead_token
  • offer_conversion_ids
  • buyers_count
  • buyer_groups_count
  • agents_count
  • record_token_filter_id
  • record_token_filter_data_count
  • record_token_filter_data
  • record_token_filter_blacklist_alliance_id
  • record_token_filter_blacklist_alliance_data_count
  • record_token_filter_blacklist_alliance_data
  • record_token_filter_tcpa_shield_id
  • record_token_filter_tcpa_shield_data_count
  • record_token_filter_tcpa_shield_data
  • record_token_filter_suppression_list_id
  • record_token_filter_suppression_list_data_count
  • record_token_filter_suppression_list_data
  • Must be String


GET /api/v1/offers/:id
Get Offer by id.

Supported Formats

json

Params

Param name
Description
serializer
Optional Blank Value Allowed

This endpoint supports multiple response formats. Pass serializer=name to retrieve data in an alternate format.

  • Must be a value contained in the pick list:
    Acceptable ValueDescription
    offerDefault response format.
    offer_gridModern response format that returns various foreign keys for use with other API endpoints.

GET /api/v1/offers/new
Build Offer with defaults.

Supported Formats

json

Params

Param name
Description
serializer
Optional Blank Value Allowed

This endpoint supports multiple response formats. Pass serializer=name to retrieve data in an alternate format.

  • Must be a value contained in the pick list:
    Acceptable ValueDescription
    offerDefault response format.
    offer_gridModern response format that returns various foreign keys for use with other API endpoints.

POST /api/v1/offers
Create Offer.

Supported Formats

json

Params

Param name
Description
serializer
Optional Blank Value Allowed

This endpoint supports multiple response formats. Pass serializer=name to retrieve data in an alternate format.

  • Must be a value contained in the pick list:
    Acceptable ValueDescription
    offerDefault response format.
    offer_gridModern response format that returns various foreign keys for use with other API endpoints.
name
Optional Blank Value Allowed

Give this offer a name. Example: Insurance Calls

  • Must be String

user_offer_id
Optional Blank Value Allowed

Give this offer a unique ID. Example: IC001

  • Must be String

description
Optional Blank Value Allowed

A human readable description of the record.

  • Must be String

paused
Optional Blank Value Allowed

Pause or unpause the offer. Paused offers will reject all calls and disable all schedules.

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

record_calls
Optional Blank Value Allowed

Record Calls

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

data_append_type
Optional Blank Value Allowed

Append additional information (such as zip code and address) to a lead, may incur additional charges.

  • Must be a value contained in the pick list:
    Acceptable ValueDescription
    free_zip_codeFree Zip Code
    zip_codeAdvanced Zip Code
    addressAddress Data
    address_plusAddress+ Data
    fullFull Data
record_calls_require_authorization
Optional Blank Value Allowed

Require the user to be logged into TrackDrive, with access to your company, in order to have permission to download call recordings on this offer.

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


PUT /api/v1/offers/:id
Update Offer by id.

Supported Formats

json

Params

Param name
Description
serializer
Optional Blank Value Allowed

This endpoint supports multiple response formats. Pass serializer=name to retrieve data in an alternate format.

  • Must be a value contained in the pick list:
    Acceptable ValueDescription
    offerDefault response format.
    offer_gridModern response format that returns various foreign keys for use with other API endpoints.
reset_numbers_api_key
Optional
  • Must be a boolean value: 1, true, yes, on, 0, false, no, off

name
Optional Blank Value Allowed

Give this offer a name. Example: Insurance Calls

  • Must be String

user_offer_id
Optional Blank Value Allowed

Give this offer a unique ID. Example: IC001

  • Must be String

description
Optional Blank Value Allowed

A human readable description of the record.

  • Must be String

paused
Optional Blank Value Allowed

Pause or unpause the offer. Paused offers will reject all calls and disable all schedules.

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

record_calls
Optional Blank Value Allowed

Record Calls

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

data_append_type
Optional Blank Value Allowed

Append additional information (such as zip code and address) to a lead, may incur additional charges.

  • Must be a value contained in the pick list:
    Acceptable ValueDescription
    free_zip_codeFree Zip Code
    zip_codeAdvanced Zip Code
    addressAddress Data
    address_plusAddress+ Data
    fullFull Data
record_calls_require_authorization
Optional Blank Value Allowed

Require the user to be logged into TrackDrive, with access to your company, in order to have permission to download call recordings on this offer.

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


DELETE /api/v1/offers/:id
Destroy Offer by id.

Supported Formats

json

Params

Param name
Description
serializer
Optional Blank Value Allowed

This endpoint supports multiple response formats. Pass serializer=name to retrieve data in an alternate format.

  • Must be a value contained in the pick list:
    Acceptable ValueDescription
    offerDefault response format.
    offer_gridModern response format that returns various foreign keys for use with other API endpoints.