API documentation

GET /tokens

Authorization Required

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

List Tokens.

Lists the tokens configured for your account - the key based variables (matching your contact fields) used to personalize IVR prompts, agent scripts, and webhooks. Hidden tokens are left out unless you pass with_hidden, and results are ordered by creation date ascending by default. Requires a superuser account.

Params

Param name	Description
page Optional	Return the next page of results. Must be a number.

Param name

Description

page
Optional

Return the next page of results.

Must be a number.

Example Request

curl 'https://[your-subdomain].trackdrive.com/api/v1/tokens/?per_page=2' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY'

Example Response 200

{
  "status": 200,
  "success": true,
  "tokens": [
    {
      "id": 10001,
      "type": "Token",
      "uuid": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
      "created_at": "2026-01-15T15:30:00.000Z",
      "updated_at": "2026-01-15T15:30:00.000Z",
      "deleted_at": null,
      "user_updated_at": null,
      "routes_show_path": "/tokens/10001",
      "routes_edit_path": "/tokens/10001/edit",
      "external_record_id": null,
      "name": "roof_shade",
      "key": "roof_shade",
      "company_id": 10002,
      "color": "#eee",
      "hidden": false,
      "background_color": "#eee",
      "static_value": null,
      "use_static_value": null,
      "description": null,
      "acceptable_tokens_enabled": false,
      "text_color": "#333",
      "sortable_order": -12,
      "html_key": "<span class=\"token-html-key\" style=\"color: #333; background-color: #eee\">roof_shade</span>",
      "type_underscore": "string",
      "inherit_from_previous_call": true
    },
    {
      "id": 10003,
      "type": "Token",
      "uuid": "a09e6bca-255b-4217-af73-cb9601c80217",
      "created_at": "2026-01-15T15:30:00.000Z",
      "updated_at": "2026-01-15T15:30:00.000Z",
      "deleted_at": null,
      "user_updated_at": null,
      "routes_show_path": "/tokens/10003",
      "routes_edit_path": "/tokens/10003/edit",
      "external_record_id": null,
      "name": "credit_score_range",
      "key": "credit_score_range",
      "company_id": 10002,
      "color": "#eee",
      "hidden": false,
      "background_color": "#eee",
      "static_value": null,
      "use_static_value": null,
      "description": null,
      "acceptable_tokens_enabled": false,
      "text_color": "#333",
      "sortable_order": -13,
      "html_key": "<span class=\"token-html-key\" style=\"color: #333; background-color: #eee\">credit_score_range</span>",
      "type_underscore": "string",
      "inherit_from_previous_call": true
    }
  ],
  "metadata": {
    "root": "tokens",
    "page": 1,
    "total_pages": 14,
    "per_page": 2,
    "total_count": 27,
    "next_cursor": 10004
  }
}