Calls API Reference - Chert FaceTime

AvailabilityCall records are GA. Events, transcripts, and summaries are in design-partner rollout.

Endpoints

GET /v1/calls
GET /v1/calls/{id}
GET /v1/calls/{id}/events
GET /v1/calls/{id}/transcript
GET /v1/calls/{id}/summary

Call record

{
  "id": "call_7d1a…",
  "direction": "inbound",
  "media": "video",
  "mode": "managed",
  "status": "ended",
  "line_id": "line_…",
  "assistant_version_id": "av_31…",
  "session_id": null,
  "started_at": "2026-08-24T17:31:02Z",
  "ended_at": "2026-08-24T17:34:36Z",
  "duration_seconds": 214,
  "terminal_reason": "remote_ended"
}

Terminal reasons include remote_ended, local_ended, line_busy, declined, webhook_timeout_declined, readiness_failed, agent_failed, and network_failed.

Lifecycle events

{
  "call_id": "call_7d1a…",
  "events": [
    { "type": "incoming_registered", "at": "…T17:30:58Z" },
    { "type": "answered", "at": "…T17:31:02Z" },
    { "type": "bridge_ready", "at": "…T17:31:08Z" },
    { "type": "agent_connected", "at": "…T17:31:10Z" },
    { "type": "remote_ended", "at": "…T17:34:36Z" },
    { "type": "cleanup_complete", "at": "…T17:34:39Z" }
  ]
}