Skip to main content
GET
Get Call Recordings Endpoint
This endpoint is in beta. The interface is stable enough to build on; we may add fields as it matures.

Overview

Pull the calls placed to a given number in your workspace, newest first, each with its timing details and a recording download URL. Use it to fetch all recordings for a lead or just the latest one, straight into your own system.

Making a request

  • Method: GET
  • URL: https://app.tuco.ai/api/voice/recordings
  • Headers: Authorization: Bearer tuco_...

Query parameters

string
required
The lead’s phone number, E.164 (e.g. +13025550123). to is accepted as an alias.
boolean
Return only the most recent call to that number.
boolean
Return only calls that have a recording URL.
number
Max calls to return. Default 20, max 100. Ignored when latest=true.

Response

Calls are returned newest first. Each entry includes timing details and the recording download URL (recordings resolve after a call ends).
string
The number you queried.
number
Number of calls returned.
array
The calls, newest first.
You only ever see calls in your own workspace. Recordings resolve a few seconds after a call ends; a null recordingUrl on a live or very recent call is expected.

Errors