List chats

GET

https://api.synthflow.ai/v2/chat

GET

/v2/chat

1 import requests
2 
3 url = "https://api.synthflow.ai/v2/chat"
4 
5 querystring = {"agent_id":"893195c1-c640-438b-9761-2e5357b01cb8"}
6 
7 headers = {"Authorization": "Bearer <token>"}
8 
9 response = requests.get(url, headers=headers, params=querystring)
10 
11 print(response.json())

Try it

200Retrieved

1 {
2   "status": "ok",
3   "response": {
4     "chats": [
5       {
6         "chat_id": "019e244b-4220-4448-9fa2-05a54d05200c",
7         "chat_status": "ongoing",
8         "start_timestamp": "2025-11-28T14:49:19.985239Z"
9       },
10       {
11         "chat_id": "3bf17be1-1d52-4f02-9e73-e88d3d6c1022",
12         "chat_status": "ongoing",
13         "start_timestamp": "2025-11-28T11:56:47.292043Z"
14       },
15       {
16         "chat_id": "893195c1-c640-438b-9761-2e5357b01cb6",
17         "chat_status": "ongoing",
18         "start_timestamp": "2025-12-01T17:55:04.175324Z"
19       },
20       {
21         "chat_id": "893195c1-c640-438b-9761-2e5357b01cb7",
22         "chat_status": "ongoing",
23         "start_timestamp": "2025-11-28T16:09:57.406442Z"
24       },
25       {
26         "chat_id": "893195c1-c640-438b-9761-2e5357b01cba",
27         "chat_status": "ongoing",
28         "start_timestamp": "2025-11-28T17:33:46.068309Z"
29       }
30     ],
31     "has_more": true,
32     "next_cursor": "eyJpZCI6Ijg5MzE5NWMxLWM2NDAtNDM4Yi05NzYxLTJlNTM1N2IwMWNiYSJ9"
33   }
34 }

Retrieve a list of chats, optionally filtered by agent ID.

Authentication

AuthorizationBearer

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

Query parameters

agent_idstringOptional

Filter chats by agent ID.

limitintegerOptionalDefaults to 10

Limit the number of chats to return.

cursorstringOptional

Cursor to start from.

Response

200

statusstring or null

Whether the request was successful.

responseobject or null

Authentication

Query parameters

Response

Errors