Get call

GET/calls/{id}

Returns the full call record including transcript, analysis, and variables (regardless of the list full flag).

Requires Authorization: Bearer <api_key>. Create a key in the Inspra dashboard under Workspace Settings → API Keys.

Path parameters

idstringrequired
UUID of the resource.

Response 200 OK

Call resource (full).

idstringoptional
Stable UUID of the call within this workspace.
call_idstringnullableoptional
Provider-side call identifier. Use to correlate with provider logs.
workspace_idstringoptional
UUID of the owning workspace.
agent_idstringnullableoptional
UUID of the agent that handled the call.
agent_namestringnullableoptional
Snapshot of the agent's name at call time (denormalised; may differ from the agent's current name).
agent_call_typestringnullableoptional
Direction of the call from the agent's perspective. One of inbound, outbound, web.
call_statusstringnullableoptional
Lifecycle state. DB enum values: initiated, ringing, in_progress, completed, failed, no_answer, busy, canceled. Providers may surface additional intermediate states.
dispositionstringnullableoptional
Business outcome label set by the post-call analysis pipeline. Known values: appointmentBooked, callbackIntent, callBack, doNotCallAgain, interested, noAnswer, noSpeech, notInterested, transferDone, voiceMail, IVR. Set may grow as new analysers ship.
disposition_statusstringnullableoptional
Sub-status for the disposition (provider-specific free-form string).
fromstringnullableoptional
E.164 caller phone number (inbound origin or outbound caller ID).
tostringnullableoptional
E.164 destination phone number.
durationnumbernullableoptional
Talk-time duration in **seconds** (from call connect to hang-up). Null while in progress.
started_atstringnullableoptional
ISO 8601 UTC timestamp when the call connected.
ended_atstringnullableoptional
ISO 8601 UTC timestamp when the call ended. Null while in progress.
created_atstringnullableoptional
ISO 8601 UTC timestamp when the call record was created (may precede started_at for queued outbound).
summarystringnullableoptional
Auto-generated one-paragraph summary from the post-call analysis pipeline.
sentimentsanyoptional
Provider-specific sentiment analysis payload. Shape varies; treat as free-form JSON.
has_prompt_analysisbooleannullableoptional
True when post-call structured analysis (criteria/structured_output) ran for this call.
transcriptobject[]nullableoptional
Full conversation transcript as a JSON array of speaker-turn objects. Present when available on list and single-call responses.
7 fields
- rolestringnullableoptional
  Speaker role, usually assistant/agent or user/customer.
- textstringnullableoptional
  Spoken text for providers that use text.
- contentanyoptional
  Spoken text for providers that use content; may be a string or provider-specific JSON.
- messagestringnullableoptional
  Spoken text for providers that use message.
- timenumbernullableoptional
  Optional provider timestamp or offset for the utterance.
- startnumbernullableoptional
  Optional provider timestamp for the start of the utterance.
- endnumbernullableoptional
  Optional provider timestamp for the end of the utterance.
transcript_with_tool_callsanyoptional
Transcript enriched with tool invocations. Present when available.
variablesanyoptional
The variables map originally sent on place-call (echoed back). Present when available.
call_analysisanyoptional
Structured analysis output (criteria results, extracted fields). Present when available.
recording_urlstringnullableoptional
Short-lived URL to the call recording when present.
ended_reasonstringnullableoptional
Provider-reported reason the call ended (e.g. customer-ended-call, silence-timed-out).

Errors

401Unauthorized
Missing, malformed, or invalid API key.
403Forbidden
Workspace unavailable, suspended, or paywalled.
404Not Found
Resource not found in this workspace.
429Too Many Requests
Workspace request limit exceeded; shared across all its API keys.