Skip to main content
GET
Get External Call
Returns the session-level call data plus each visible recording leg in chronological order. Transcripts and summaries are null while processing is incomplete. recording_presigned_urls contains a URL for every playable recording in the session, in chronological order. URLs expire after one hour. Recordings awaiting required audio redaction are omitted until they are playable. If URL signing temporarily fails for a recording, its URL is omitted and the call data is still returned. The array is empty when no recording URLs are available. Learn how Simple AI represents call data in the AI phone calls guide. Recording links in recording_presigned_urls are temporary HTTPS playback URLs. Use each complete URL as returned, including its query parameters; the hostname and URL structure may change. Anyone with a valid link can access its recording until the link expires.

Authorizations

Authorization
string
header
required

Your API key, sent as Authorization: Bearer YOUR_API_KEY

Path Parameters

uuid
string<uuid>
required

Response

External call returned

id
string<uuid>
required
external_call_id
string
required
title
string | null
required
direction
enum<string> | null
required
Available options:
inbound,
outbound
from_number
string | null
required
to_number
string | null
required
duration_seconds
integer | null
required
started_at
string<date-time>
required
status
enum<string>
required
Available options:
processing,
transcribed,
error
recording_count
integer
required
Required range: x >= 0
source
External Call Source · object | null
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
recording_presigned_urls
string<uri>[]
required

Presigned URLs for all playable recordings in chronological order. External calls can have multiple recordings per session. URLs expire after one hour. Deleted, excluded, and recordings awaiting required audio redaction are omitted; an empty array means no recordings are currently playable. If URL signing fails for a recording, its URL is omitted and the call data is still returned.

recordings
External Call Recording · object[]
required
Last modified on October 3, 2026