Call Detail
If you know a call’s callId (for example from the Call Analysis Completed webhook or the Call Records response), you can fetch that call directly with this endpoint instead of scanning the whole list.
Query Parameters
Example cURL
curl --request GET 'https://public-api.thinkvoice.ai/api/app/public-calls/call?callId=019e925a-5f79-7778-b0be-a45a146cf828' \
--header 'Authorization: Bearer <ACCESS_TOKEN>'Responses
The response body is a single object with the same fields as the items entries in the Call Records response; see the Response Fields table on that page for field descriptions. The difference: in the Call Detail response the analysis field is always populated (in Call Records it is populated only when includeAnalysis: true). The body is not wrapped in an items list as in Call Records.
Error Cases
| Case | HTTP | Description |
|---|---|---|
| Missing or invalid token | 401 | The Authorization header is missing, invalid or expired. |
| Call not found | 403 | Returned if the callId is wrong or the call belongs to another tenant. A call from another tenant is never returned under any circumstances. |
Invalid callId format | 400 | callId is not a valid UUID. |
Call Detail only returns meaningful results for calls whose analysis is complete. For a call whose analysis has not finished, fields such as topic, summary and resolution status may be empty. We recommend waiting for the webhook notification sent when the call analysis completes and querying afterwards.
You can download the call recording from the recordUrl in the response. See the Call Recording page for details.