Retrieve Call Results | FormantAI

List recent conversations

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

Get a single conversation

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

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:

Receive call.completed.
Store the webhook payload.
Use conversation_id to fetch full details if needed.
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.