API documentation

GET /standalone_transcriptions

Authorization Required

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

List Standalone Transcription records.

Returns Standalone Transcriptions: audio files submitted for transcription independent of a Trackdrive call or lead. Defaults to the current day if no date range is given. Restricted to account superusers.

Params

Param name	Description
ids Optional	Return records matching these ids. Must be an array of decimal values. EG: `[0, 1, 2, 3]`
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 a String
created_at_from Optional	Date formatted like 2016-01-01 12:25:15 -0500 Must be a String
fulltext Optional	Search for any record that matches this text Must be a String
time_zone Optional	Date ranges will be parsed using this time zone. Must be a valid time zone. See the list of valid time zones.
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 company_id file_url transcription_flow_group_id postback_url dual_channel speakers body highlight_wrapper_open highlight_wrapper_close audio_duration transcription_processed keywords utterances highlighted_utterances caller_id data original_data Must be a 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

Example Request

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

Example Response 200

{
  "status": 200,
  "success": true,
  "standalone_transcriptions": [
    {
      "id": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
      "type": "StandaloneTranscription",
      "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": "/standalone_transcriptions/a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
      "routes_edit_path": "/standalone_transcriptions/a6af7847-1b1e-4760-ac0d-e1813a6d3a09/edit",
      "external_record_id": null,
      "company_id": 10001,
      "file_url": "https://example.com/publicly_accessible_file.mp3",
      "transcription_flow_group_id": null,
      "postback_url": "https://example.com/postback_url_without_authentication",
      "dual_channel": true,
      "speakers": null,
      "body": "Thanks for calling, we'll have someone reach back out within the hour.",
      "highlight_wrapper_open": "{{",
      "highlight_wrapper_close": "}}",
      "audio_duration": null,
      "transcription_processed": null,
      "keywords": null,
      "utterances": null,
      "highlighted_utterances": null,
      "caller_id": "+1719000002",
      "data": "{}",
      "original_data": "null"
    },
    {
      "id": "a09e6bca-255b-4217-af73-cb9601c80217",
      "type": "StandaloneTranscription",
      "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": "/standalone_transcriptions/a09e6bca-255b-4217-af73-cb9601c80217",
      "routes_edit_path": "/standalone_transcriptions/a09e6bca-255b-4217-af73-cb9601c80217/edit",
      "external_record_id": null,
      "company_id": 10001,
      "file_url": "https://example.com/publicly_accessible_file.mp3",
      "transcription_flow_group_id": null,
      "postback_url": "https://example.com/postback_url_without_authentication",
      "dual_channel": true,
      "speakers": null,
      "body": "Hi, I wanted to follow up on the quote you sent over last week.",
      "highlight_wrapper_open": "{{",
      "highlight_wrapper_close": "}}",
      "audio_duration": null,
      "transcription_processed": null,
      "keywords": null,
      "utterances": null,
      "highlighted_utterances": null,
      "caller_id": "+1719000001",
      "data": "{}",
      "original_data": "null"
    }
  ],
  "metadata": {
    "root": "standalone_transcriptions",
    "page": 1,
    "total_pages": 1,
    "per_page": 2,
    "total_count": 2,
    "next_cursor": 10002
  }
}

GET /standalone_transcriptions/new

Authorization Required

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

Build Standalone Transcription with defaults.

Returns a Standalone Transcription built with default attributes for previewing available fields. It is not saved.

Params

Param name	Description
file_url Optional	Audio File URL location. This must be a publicly accessible URL, and cannot have IP restrictions. Must be a String
postback_url Optional	Postback URL that we will send the following JSON payload to when the transcription is complete: id, highlighted_utterances, keywords, data, body, utterances, file_url Must be a String
caller_id Optional Blank value allowed	Caller ID associated with the audio file, which may be used for addition triggers and actions. Must be a String
dual_channel Optional Blank value allowed	Is the audio file dual channel? Must be a boolean value: 1, true, yes, on, 0, false, no, off
speakers Optional Blank value allowed	Number of people (speakers) in the audio file. Must be a decimal number.
highlight_wrapper_open Optional Blank value allowed	When keywords are highlighted, this is the opening tag, e.g. “This is a {{keyword}}.” Must be a String
highlight_wrapper_close Optional Blank value allowed	When keywords are highlighted, this is the closing tag, e.g. “This is a {{keyword}}.” Must be a String
transcription_flow_group_id Optional Blank value allowed	Transcription Flow Group that will be used to process the transcription. This will be used even if an Offer with a Transcription Flow Group is provided. Must be a valid foreign key reference to an Transcription Flow Group. Refer to: /api/docs/1.0/transcription_flow_groups
offer_id Optional Blank value allowed	Offer that will be used to process the transcription. This will be used if a Transcription Flow Group is not provided, as long as the Offer has a Transcription Flow Group. Must be a valid foreign key reference to an Offer. Refer to: /api/docs/1.0/offers
data Optional Blank value allowed	A JSON object that is used to store information to filter Transcription Flows and Schedule Action Groups. It is automatically updated with Trackdrive tokens (such as zip code, state, etc.). Extra tokens can be applied to Data when specific keywords are found (Transcription Keyword settings), or when an Action is triggered (Action Group > Action settings). Must be a Hash

Example Request

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

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "standalone_transcription": {
    "id": null,
    "type": "StandaloneTranscription",
    "uuid": null,
    "created_at": null,
    "updated_at": null,
    "deleted_at": null,
    "user_updated_at": null,
    "routes_show_path": "/standalone_transcriptions/new",
    "routes_edit_path": "/standalone_transcriptions/new",
    "external_record_id": null,
    "company_id": 10001,
    "file_url": null,
    "transcription_flow_group_id": null,
    "postback_url": null,
    "dual_channel": null,
    "speakers": null,
    "body": null,
    "highlight_wrapper_open": "{{",
    "highlight_wrapper_close": "}}",
    "audio_duration": null,
    "transcription_processed": null,
    "keywords": null,
    "utterances": null,
    "highlighted_utterances": null,
    "caller_id": null,
    "data": "{}",
    "original_data": "null"
  },
  "metadata": {
    "root": "standalone_transcription"
  }
}

POST /standalone_transcriptions

Authorization Required

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

Create Standalone Transcription.

Submits a publicly accessible audio file URL for transcription. Processing is asynchronous and is billed; once complete, Trackdrive posts the resulting transcript, utterances, and detected keywords to the given postback_url. Restricted to account superusers.

Params

Param name	Description
file_url Required	Audio File URL location. This must be a publicly accessible URL, and cannot have IP restrictions. Must be a String
postback_url Required	Postback URL that we will send the following JSON payload to when the transcription is complete: id, highlighted_utterances, keywords, data, body, utterances, file_url Must be a String
caller_id Optional Blank value allowed	Caller ID associated with the audio file, which may be used for addition triggers and actions. Must be a String
dual_channel Optional Blank value allowed	Is the audio file dual channel? Must be a boolean value: 1, true, yes, on, 0, false, no, off
speakers Optional Blank value allowed	Number of people (speakers) in the audio file. Must be a decimal number.
highlight_wrapper_open Optional Blank value allowed	When keywords are highlighted, this is the opening tag, e.g. “This is a {{keyword}}.” Must be a String
highlight_wrapper_close Optional Blank value allowed	When keywords are highlighted, this is the closing tag, e.g. “This is a {{keyword}}.” Must be a String
transcription_flow_group_id Optional Blank value allowed	Transcription Flow Group that will be used to process the transcription. This will be used even if an Offer with a Transcription Flow Group is provided. Must be a valid foreign key reference to an Transcription Flow Group. Refer to: /api/docs/1.0/transcription_flow_groups
offer_id Optional Blank value allowed	Offer that will be used to process the transcription. This will be used if a Transcription Flow Group is not provided, as long as the Offer has a Transcription Flow Group. Must be a valid foreign key reference to an Offer. Refer to: /api/docs/1.0/offers
data Optional Blank value allowed	A JSON object that is used to store information to filter Transcription Flows and Schedule Action Groups. It is automatically updated with Trackdrive tokens (such as zip code, state, etc.). Extra tokens can be applied to Data when specific keywords are found (Transcription Keyword settings), or when an Action is triggered (Action Group > Action settings). Must be a Hash

Example Request

curl -X POST 'https://[your-subdomain].trackdrive.com/api/v1/standalone_transcriptions/' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "caller_id": "+18004506787",
  "file_url": "https://example.com/publicly_accessible_file.mp3",
  "postback_url": "https://example.com/postback_url_without_authentication",
  "dual_channel": true,
  "data": {
    "loan_amount": "501",
    "custom_token": "the_value"
  }
}'

Example Response 201

{
  "status": 201,
  "success": true,
  "errors": {},
  "standalone_transcription": {
    "id": "a0d49c48-1b1e-4760-ac0d-da771aa599db",
    "type": "StandaloneTranscription",
    "uuid": "a0d49c48-1b1e-4760-ac0d-da771aa599db",
    "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": "/standalone_transcriptions/a0d49c48-1b1e-4760-ac0d-da771aa599db",
    "routes_edit_path": "/standalone_transcriptions/a0d49c48-1b1e-4760-ac0d-da771aa599db/edit",
    "external_record_id": null,
    "company_id": 10001,
    "file_url": "https://example.com/publicly_accessible_file.mp3",
    "transcription_flow_group_id": null,
    "postback_url": "https://example.com/postback_url_without_authentication",
    "dual_channel": true,
    "speakers": null,
    "body": null,
    "highlight_wrapper_open": "{{",
    "highlight_wrapper_close": "}}",
    "audio_duration": null,
    "transcription_processed": null,
    "keywords": null,
    "utterances": null,
    "highlighted_utterances": null,
    "caller_id": "+18004506787",
    "data": "{\"loan_amount\":\"501\",\"custom_token\":\"the_value\"}",
    "original_data": "null"
  },
  "metadata": {
    "root": "standalone_transcription"
  }
}

GET /standalone_transcriptions/:id

Authorization Required

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

Get Standalone Transcription by id.

Returns a single Standalone Transcription by id, including its processing status and, once complete, the transcript body, utterances, and detected keywords. Restricted to account superusers.

Params

Param name	Description
caller_id Optional Blank value allowed	Caller ID associated with the audio file, which may be used for addition triggers and actions. Must be a String
dual_channel Optional Blank value allowed	Is the audio file dual channel? Must be a boolean value: 1, true, yes, on, 0, false, no, off
speakers Optional Blank value allowed	Number of people (speakers) in the audio file. Must be a decimal number.
highlight_wrapper_open Optional Blank value allowed	When keywords are highlighted, this is the opening tag, e.g. “This is a {{keyword}}.” Must be a String
highlight_wrapper_close Optional Blank value allowed	When keywords are highlighted, this is the closing tag, e.g. “This is a {{keyword}}.” Must be a String
transcription_flow_group_id Optional Blank value allowed	Transcription Flow Group that will be used to process the transcription. This will be used even if an Offer with a Transcription Flow Group is provided. Must be a valid foreign key reference to an Transcription Flow Group. Refer to: /api/docs/1.0/transcription_flow_groups
offer_id Optional Blank value allowed	Offer that will be used to process the transcription. This will be used if a Transcription Flow Group is not provided, as long as the Offer has a Transcription Flow Group. Must be a valid foreign key reference to an Offer. Refer to: /api/docs/1.0/offers
data Optional Blank value allowed	A JSON object that is used to store information to filter Transcription Flows and Schedule Action Groups. It is automatically updated with Trackdrive tokens (such as zip code, state, etc.). Extra tokens can be applied to Data when specific keywords are found (Transcription Keyword settings), or when an Action is triggered (Action Group > Action settings). Must be a Hash
original_data Optional	The original data that was provided when the transcription record was created. Must be a Hash
keywords Optional	Keywords that were found in the audio file. Must be a boolean value: 1, true, yes, on, 0, false, no, off
utterances Optional	Utterances are the spoken words in the audio file, broken down by speaker. Must be a Hash
highlighted_utterances Optional	Highlighted Utterances are the spoken words in the audio file, broken down by speaker, with keywords highlighted. Must be a Hash
transcription_processed Optional	Returns true if the audio file has been transcribed and keywords have been highlighted. Must be a boolean value: 1, true, yes, on, 0, false, no, off
audio_duration Optional	The detected duration of the audio file in seconds. Must be a decimal number.
body Optional	The raw transcription text of the audio file. Must be a String

Example Request

curl 'https://[your-subdomain].trackdrive.com/api/v1/standalone_transcriptions/a6af7847-1b1e-4760-ac0d-e1813a6d3a09' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY'

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "standalone_transcription": {
    "id": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "type": "StandaloneTranscription",
    "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": "/standalone_transcriptions/a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "routes_edit_path": "/standalone_transcriptions/a6af7847-1b1e-4760-ac0d-e1813a6d3a09/edit",
    "external_record_id": null,
    "company_id": 10001,
    "file_url": "https://example.com/publicly_accessible_file.mp3",
    "transcription_flow_group_id": null,
    "postback_url": "https://example.com/postback_url_without_authentication",
    "dual_channel": true,
    "speakers": null,
    "body": "Thanks for calling, we'll have someone reach back out within the hour.",
    "highlight_wrapper_open": "{{",
    "highlight_wrapper_close": "}}",
    "audio_duration": null,
    "transcription_processed": null,
    "keywords": null,
    "utterances": null,
    "highlighted_utterances": null,
    "caller_id": "+1719000002",
    "data": "{}",
    "original_data": "null"
  },
  "metadata": {
    "root": "standalone_transcription"
  }
}

DELETE /standalone_transcriptions/:id

Authorization Required

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

Destroy Standalone Transcription by id.

Permanently deletes a Standalone Transcription record. Restricted to account superusers.

Example Request

curl -X DELETE 'https://[your-subdomain].trackdrive.com/api/v1/standalone_transcriptions/a0d49c48-1b1e-4760-ac0d-da771aa599db' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY'

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "standalone_transcription": {
    "id": "a0d49c48-1b1e-4760-ac0d-da771aa599db",
    "type": "StandaloneTranscription",
    "uuid": "a0d49c48-1b1e-4760-ac0d-da771aa599db",
    "created_at": "2026-01-15T15:30:00.000Z",
    "updated_at": "2026-01-15T15:30:00.000Z",
    "deleted_at": "2026-01-15T15:30:00.000Z",
    "user_updated_at": null,
    "routes_show_path": "/standalone_transcriptions/a0d49c48-1b1e-4760-ac0d-da771aa599db",
    "routes_edit_path": "/standalone_transcriptions/a0d49c48-1b1e-4760-ac0d-da771aa599db/edit",
    "external_record_id": null,
    "company_id": 10001,
    "file_url": "https://example.com/publicly_accessible_file.mp3",
    "transcription_flow_group_id": null,
    "postback_url": "https://example.com/postback_url_without_authentication",
    "dual_channel": true,
    "speakers": null,
    "body": "Thanks for calling, we'll have someone reach back out within the hour.",
    "highlight_wrapper_open": "{{",
    "highlight_wrapper_close": "}}",
    "audio_duration": null,
    "transcription_processed": null,
    "keywords": null,
    "utterances": null,
    "highlighted_utterances": null,
    "caller_id": "+1719000002",
    "data": "{}",
    "original_data": "null"
  },
  "metadata": {
    "root": "standalone_transcription"
  }
}

Params

Must be any combination of:

Params

Params

Params