Get Call Recordings Endpoint
Voice / Calling
Get Call Recordings Endpoint
Fetch a lead’s calls with timing details and the recording download URL, by phone number, using your API key.
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.