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())

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

Whether the request was successful.

responseobject

Errors

400

Bad Request Error