List conversations

GET

/v1/conversations

GET

/v1/conversations

$ curl https://api.voice.formantai.com/v1/conversations \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json"

1 {
2   "data": [
3     {
4       "agent_id": 12345,
5       "contact_number": "+14155552671",
6       "conversation_id": "conv_9876543210abcdef",
7       "duration_seconds": 245.7,
8       "end_timestamp": 1685606400,
9       "failure_reason": null,
10       "results": {
11         "call_quality": "excellent",
12         "transcription_confidence": 0.95
13       },
14       "start_timestamp": 1685606154,
15       "status": "completed",
16       "trace_id": "trace_4f3b2a1c9d8e7f6a",
17       "transcript": [
18         {
19           "speaker": "agent",
20           "text": "Hello, thank you for calling FormantAI support. How can I assist you today?",
21           "timestamp": 1685606155
22         },
23         {
24           "speaker": "customer",
25           "text": "Hi, I need help with my account settings.",
26           "timestamp": 1685606160
27         }
28       ]
29     }
30   ],
31   "has_more": false,
32   "total": 1
33 }

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

agent_idintegerOptional

limitintegerOptional<=100Defaults to 20

offsetintegerOptionalDefaults to 0

Response

Conversation list

datalist of objects

has_moreboolean

totalinteger

Errors

401

Unauthorized Error