> ## Documentation Index
> Fetch the complete documentation index at: https://docs.facetime.trychert.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Calls API Reference

> Inspect call records and rollout metadata.

<Note>
  **Availability**

  Call records are GA. Events, transcripts, and summaries are in design-partner rollout.
</Note>

<h2 id="endpoints">
  Endpoints
</h2>

```http theme={null}
GET /v1/calls
GET /v1/calls/{id}
GET /v1/calls/{id}/events
GET /v1/calls/{id}/transcript
GET /v1/calls/{id}/summary
```

<h2 id="record">
  Call record
</h2>

```json theme={null}
{
  "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`.

<h2 id="events">
  Lifecycle events
</h2>

```json theme={null}
{
  "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" }
  ]
}
```