Get call

Retrieves the full detail of a single call by its uid, including the conversation transcript and a link to the recording.

Endpoint

GET /v1/calls/:uid

Path parameters

Parameter	Type	Description
uid	string	Unique identifier of the call. Get it from List calls or from the end-of-call webhook.

Request example

curl -X GET "https://api.fonema.ai/v1/calls/aBcDeFgHiJkL" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"

Response

{
  "uid": "aBcDeFgHiJkL",
  "agent": { "name": "Sales Agent", "slug": "sales-agent-ab12cd34" },
  "toNumber": "+525599999999",
  "endedReason": "customer-ended-call",
  "createdAt": "2026-08-06T17:00:00.000Z",
  "startAt": "2026-08-06T17:00:05.000Z",
  "endAt": "2026-08-06T17:02:35.000Z",
  "durationSeconds": 150,
  "successEvaluation": true,
  "inputData": {
    "name": "Juan Perez",
    "montoDeuda": "30000"
  },
  "outputData": {
    "summary": "The customer agreed to pay the outstanding balance on Friday.",
    "successEvaluation": "true",
    "fechaPago": "2026-08-08"
  },
  "transcript": [
    { "role": "agent", "content": "Hi, thanks for taking my call!", "secondsFromStart": 0 },
    { "role": "user", "content": "Hello, who is this?", "secondsFromStart": 4 }
  ],
  "audioUrl": "/v1/calls/aBcDeFgHiJkL/audio.mp3"
}

Response fields

Field	Type	Description
uid	string	Unique call identifier.
agent	object	The agent that handled the call (name and slug).
toNumber	string	Phone number that was called, in E.164 format.
endedReason	string	Why the call ended (e.g. customer-ended-call, voicemail).
createdAt	string	When the call was created (queued).
startAt	string | null	When the call was answered. null if it never connected.
endAt	string | null	When the call ended.
durationSeconds	integer	Call duration in seconds. 0 if the call never connected.
successEvaluation	boolean	Whether the call met the agent's success criteria.
inputData	object	The variables provided when the call was created.
outputData	object	End-of-call results: summary, successEvaluation, and any output variables captured by the agent.
transcript	array	Conversation transcript, ordered by time. Each entry has role (agent or user), content, and secondsFromStart.
audioUrl	string | null	Path to the call recording, relative to https://api.fonema.ai. null if no recording is available.

Download the recording

The recording endpoint accepts the same API key:

GET /v1/calls/:uid/audio.mp3

curl -X GET "https://api.fonema.ai/v1/calls/aBcDeFgHiJkL/audio.mp3" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -o recording.mp3

Errors

Status	Description
404	Call not found or not accessible by this API key.