Skip to main content
GET
Retrieve A Call

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

call_id
string
required

Response

Successful response

direction
enum<string>
required
Available options:
inbound,
outbound
Maximum string length: 8
object
string
required
to_number
string
required

The number to call

id
string
Maximum string length: 32
agent_id
string | null
approver
object
approver_id
string | null
Maximum string length: 32
call_agent_id
string | null
Maximum string length: 32
call_reason
string | null
classifications
object[]
created_at
string<date-time>
custom_classifications
string[] | null

Custom classifications for the call.

disconnection_reason
string | null
end_time
string<date-time> | null
from_number
string | null

The calling number.

in_voicemail
boolean

Whether the call is entered voicemail.

invoices
object[]
is_automated
boolean

Whether the call was automatically initiated by a workflow or an AI agent.

modified_at
string<date-time> | null
partner
object
partner_id
string | null
Maximum string length: 32
recording_url
any
retell_id
string | null
sentiment
enum<string> | null

Sentiment of the user in the call.

Available options:
positive,
negative,
neutral,
unknown,
null
Maximum string length: 8
start_time
string<date-time> | null
status
enum<string>
Available options:
pending_approval,
queued,
registered,
initiated,
ringing,
canceled,
in_progress,
completed,
busy,
no_answer,
failed
Maximum string length: 16
summary
string | null

The summary of the call.

transcript
any
transcript_str
string | null

The transcript of the call.

transferred_to
string | null

The number the call was transferred to, if any. This is typically used for inbound calls where the call was transferred to a different number.

Maximum string length: 32
workflow
object