API documentation

GET /tokens/:id

Authorization Required

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

Get Token by id.

Retrieves a single token by id, restricted to tokens your account can access. Requires a superuser account.

Example Request

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

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "token": {
    "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
  },
  "metadata": {
    "root": "token"
  }
}