Monitor

Retrieve Call Results

View as Markdown

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:

  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.