Skip to main content
GET

Get call insight

Returns what the agent captured in one conversation: whether a person answered, the result, the data the agent was configured to collect, a summary and the full transcript. This is the same information the event_call_report webhook delivers, available on demand. Use it to reconcile a call without depending on the webhook, or to read the summary and transcript, which are not included in List calls because of their size.

Endpoint

Path parameters

string
required
The call’s id, as returned by List calls or Make a call.

Request headers

string
required
Bearer token. Format: Bearer talq_your_environment_token_here

Example request

Response

Success response (200 OK)

Response fields

boolean
required
Whether the request succeeded.
object
required
human_detected, objective_achieved, call_result, collected_data and summary are null whenever analysis_status is not completed. A false in those fields is a real result of the analysis, never its absence.

Reading analysis_status

The analysis runs after the call ends, usually within a minute. A call queried right after it ends has no result yet. A call never goes from unavailable back to completed. Once you see unavailable, stop querying. voicemail calls follow the normal flow (pending, then completed or unavailable), because the agent may have talked before the voicemail was detected.

Error responses

404 Not found

The call does not exist or belongs to another environment.

401 Unauthorized

Notes

duration: null on voicemail, no-answer, failed and busy calls means no talk time was measured. It is not zero.
Batch reconciliation. To reconcile a day, use List calls with include=insight, at least 30 minutes after the last call ended. pending disappears and you get one request per page instead of one per call.
Deliberately excluded. The provider’s call SID, internal routing flags and the remaining analysis fields (sentiment, objections, script completion) are not part of this response.
  • List calls: GET /api/v1/calls?include=insight — the same block, without summary and transcript, for a whole page of calls.
  • Get agent calls: GET /api/v1/agents/{agent_id}/calls?include=insight
  • Get recording URL: GET /api/v1/calls/{call_id}/recording-url