Skip to main content
GET
/
calls
/
{call_id}
Get Call
curl --request GET \
  --url https://api.puppeteerai.com/calls/{call_id} \
  --header 'Authorization: <authorization>'
{
  "id": "<string>",
  "thread_id": "<string>",
  "call_type": "<string>",
  "status": "<string>",
  "created_at": "<string>",
  "conversation_id": 123,
  "direction": "<string>",
  "from_number": "<string>",
  "to_number": "<string>",
  "scheduled_for": "<string>",
  "start_timestamp": 123,
  "end_timestamp": 123,
  "duration_ms": 123,
  "disconnection_reason": "<string>",
  "transcript": "<string>",
  "transcript_object": "<unknown>",
  "recording_url": "<string>",
  "call_analysis": "<unknown>"
}

Headers

​
Authorization
string
required

Path Parameters

​
call_id
string
required

Response

Successful Response

​
id
string
required

Unique identifier of the call.

​
thread_id
string
required

Identifier of the thread this call belongs to.

​
call_type
string
required

Type of the call, e.g. "phone_call" or "web_call".

​
status
string
required

Current status, e.g. "scheduled", "ongoing", "ended", "error".

​
created_at
string
required

ISO 8601 timestamp when the call record was created.

​
conversation_id
integer | null

Identifier of the conversation, or null for scheduled calls that never started.

​
direction
string | null

Call direction, "inbound" or "outbound".

​
from_number
string | null

Originating phone number (phone calls only).

​
to_number
string | null

Destination phone number (phone calls only).

​
scheduled_for
string | null

ISO 8601 timestamp the call is scheduled for, or null.

​
start_timestamp
integer | null

Unix timestamp (seconds) when the call started, or null if it has not started.

​
end_timestamp
integer | null

Unix timestamp (seconds) when the call ended, or null if it has not ended.

​
duration_ms
integer | null

Call duration in milliseconds, or null.

​
disconnection_reason
string | null

Reason the call ended, if known.

​
transcript
string | null

Plain-text transcript of the call, if available.

​
transcript_object
any | null

Structured per-utterance transcript, if available.

​
recording_url
string | null

URL to the call recording. Self-hosted recordings return a short-lived signed URL.

​
call_analysis
any | null

Post-call analysis (summary, sentiment, custom fields), if available.