Get call status and result
get_callGet the status and written result of a call placed with place_phone_call (outcome, summary, pending question, transcript on request), optionally waiting for news. Compliance: read-only; transcripts are text only (no audio is recorded) and are kept 90 days at most.
Use it to follow a call in progress (repeat until done=true), to see whether the voice agent is waiting for the user's answer (pending_question), and to read the final outcome and summary to report to the user. Read-only: it never places, changes or ends a call.
Returns: status (scheduled, in_progress, retry_scheduled, completed, cancelled, failed), done, outcome (success, failed, voicemail, no_answer, busy, callback_requested, callee_objected), summary, pending_question {question_id, text}, new events since after_event_id, last_event_id and next_step. A call that is busy or not answered is retried automatically (status retry_scheduled), except on lines where every call needs a new request from the user (event callback_suggested: ask the user). callee_objected means the person asked not to be called again: the transcript was deleted and the number can no longer be called; tell the user.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| call_id | Yes | The call_id returned by place_phone_call or list_calls (e.g. 'mis_…'). | |
| wait_seconds | No | Seconds (0-50) to wait for news before returning: returns early when the callee answers, the call goes on hold, the voice agent asks a question, a transfer progresses or the call ends. Use 20-30 while a call is in progress, 0 for an instant snapshot. | |
| after_event_id | No | Return only events after this id: pass last_event_id from the previous get_call response. 0 = from the start. | |
| response_format | No | 'concise' (default): status, outcome, summary, pending question and key events. 'detailed': also every transcript line, talk and hold durations, attempts and scheduled time. | concise |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| done | No | ||
| events | No | ||
| status | No | ||
| call_id | No | ||
| outcome | No | ||
| summary | No | ||
| attempts | No | ||
| language | No | ||
| next_step | No | ||
| transcript | No | ||
| latest_line | No | ||
| hold_seconds | No | ||
| phone_number | No | ||
| last_event_id | No | ||
| scheduled_for | No | ||
| pending_question | No | ||
| talk_seconds_billed | No | ||
| new_transcript_lines | No |