> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.formantai.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.formantai.com/_mcp/server.

# Retrieve Call Results

> Fetch transcripts, structured outputs, and recordings after calls complete.

## List recent conversations

```bash
curl "https://api.voice.formantai.com/v1/conversations?agent_id=123&limit=20" \
  -H "Authorization: Bearer $FORMANT_API_KEY"
```

## Get a single conversation

```bash
curl "https://api.voice.formantai.com/v1/conversations/e36853de-9cbb-441e-ad75-d3c8ac82abfb_1" \
  -H "Authorization: Bearer $FORMANT_API_KEY"
```

Use this response to store:

* `status`
* `failure_reason`
* `results`
* `transcript`
* `trace_id`
* `duration_seconds`

## Download recording

```bash
curl "https://api.voice.formantai.com/v1/conversations/e36853de-9cbb-441e-ad75-d3c8ac82abfb_1/recording" \
  -H "Authorization: Bearer $FORMANT_API_KEY" \
  --output call.wav
```

## Webhook-first pattern

In production, webhooks should trigger result processing:

1. Receive `call.completed`.
2. Store the webhook payload.
3. Use `conversation_id` to fetch full details if needed.
4. Download recording if your workflow requires local archival.

Webhook payloads can include transcript and recording URL, but the Conversations API is the source of truth for later reconciliation.