Calls: Recordings

Every call recording a company keeps, each with its call and a link that downloads the file.

GET /call_recordings

Authorization Required
https://[your-subdomain].trackdrive.com/api/v1/call_recordings

List call recordings by cursor.

Lists every recording the company keeps, newest first, each with its recording fields, its call as the Calls endpoint returns it, and a recording_url. Page through the list by passing metadata.next_cursor as cursor; there are no page numbers or totals, and next_cursor is null after the last recording. offer_id, schedule_id, collaborator_id (the call's agent) and buyer_id narrow the list, and a filtered page can come back short or empty while next_cursor continues the scan. Download each file with a second request to its recording_url, which redirects to the file. Requires a superuser with the Calls permission.

Params

Param name Description
cursor
Optional Blank value allowed

Pass metadata.next_cursor from the previous response to read the next page. Leave it out to start at the newest recording, or the oldest with order_dir=asc. next_cursor is null once the last recording has been read.

  • Must be a decimal number.
order_dir
Optional Blank value allowed

desc (default) lists the newest recording first; asc lists the oldest first.

  • Must be one of: asc, desc.
per_page
Optional Blank value allowed

Recordings per page, at most 500 (default 25).

  • Must be a number.
offer_id
Optional Blank value allowed

Only recordings of this offer. One id or a comma-separated list.
schedule_id
Optional Blank value allowed

Only recordings of this schedule. One id or a comma-separated list.
collaborator_id
Optional Blank value allowed

Only recordings whose call was taken by this agent. One id or a comma-separated list.
buyer_id
Optional Blank value allowed

Only recordings of this buyer. One id or a comma-separated list.