Calls
Get call
Retrieves the full detail of a single call by its uid, including the conversation transcript and a link to the recording.
Authentication
AuthorizationBearerAuthenticate server-side requests with a Fonema API key. Create one in the API keys section of the Dashboard and send it in the Authorization header as Bearer <token>. Keep keys out of client-side code and public repositories.
Path parameters
uidstringRequiredUnique identifier of the call. Get it from List calls or from the end-of-call webhook.
Response
uidstringagentobjectname and slug).toNumberstringendedReasonstringcustomer-ended-call, voicemail).createdAtstringstartAtstring | nullnull if it never connected.endAtstring | nulldurationSecondsinteger0 if the call never connected.successEvaluationbooleaninputDataobjectoutputDataobjectEnd-of-call results: summary, successEvaluation, and any output variables captured by the agent.
transcriptarrayConversation transcript, ordered by time. Each entry has role (agent or user), content, and secondsFromStart.
audioUrlstring | nullPath 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
404