Skip to main content
Retrieves detailed information about a specific call by its ID. The call must belong to an agent that belongs to your company. Transcript and recording URLs are presigned and valid for 60 minutes.
​
X-API-Key
string
required
Your unique organization API key. Required on all requests.

​
Path parameters

​
call_id
string
required
The UUID of the call to retrieve. Returned as call_id from the Trigger call endpoint.

​
Response

​
Success (200 OK)

​
message
string
Human-readable status message.
​
data
object
The call details object.
​
data.agent_id
string
The UUID of the AI agent that conducted the call.
​
data.created_at
string
Timestamp when the call record was created (ISO 8601).
​
data.updated_at
string
Timestamp when the call record was last updated (ISO 8601).
​
data.started_at
string | null
Timestamp when the call started (ISO 8601). Null if not yet started.
​
data.ended_at
string | null
Timestamp when the call ended (ISO 8601). Null if not yet ended.
​
data.transcript_url
string | null
Presigned URL to access the call transcript (valid for 60 minutes). Null if not available.
​
data.recording_url
string | null
Presigned URL to access the call recording (valid for 60 minutes). Null if not available.
​
data.status
string
Current status of the call. One of: PENDING, TRIGGERED, ONGOING, CALL_FINISHED, UNANSWERED, REJECTED.
​
data.call_variables
object | null
Additional variables associated with the call (e.g. metadata passed at trigger time). Null if none.

​
Errors

StatusDescription
400Bad request — invalid call ID format
404Call not found or does not belong to your company
500Internal server error

​
Examples

curl -X GET "https://api.samora.ai/v1/call/550e8400-e29b-41d4-a716-446655440000" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "message": "Call details fetched successfully",
  "data": {
    "agent_id": "123e4567-e89b-12d3-a456-426614174000",
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T10:35:00Z",
    "started_at": "2024-01-15T10:30:05Z",
    "ended_at": "2024-01-15T10:35:30Z",
    "transcript_url": "https://s3.amazonaws.com/bucket/transcript.pdf?X-Amz-Algorithm=...",
    "recording_url": "https://s3.amazonaws.com/bucket/recording.mp3?X-Amz-Algorithm=...",
    "status": "CALL_FINISHED",
    "call_variables": {
      "name": "John Doe",
      "email": "[email protected]",
      "customer_id": "CUST-001"
    }
  }
}

{
  "message": "Call not found or does not belong to your company"
}