List conversations
curl --request GET \
--url https://api.operator.xyz/conversations \
--header 'Authorization: Bearer <token>' \
--header 'Operator-Version: <operator-version>'import requests
url = "https://api.operator.xyz/conversations"
headers = {
"Operator-Version": "<operator-version>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'Operator-Version': '<operator-version>', Authorization: 'Bearer <token>'}
};
fetch('https://api.operator.xyz/conversations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"id": "<string>",
"agent_id": "<string>",
"livemode": true,
"created_at": "2023-11-07T05:31:56Z",
"direction": "inbound",
"status": "queued",
"custom_fields": {},
"customer_id": null,
"channel_type": null,
"started_at": null,
"completed_at": null,
"failure_reason": null,
"duration_sec": null,
"sentiment": null
}
],
"cursor": null
}{
"code": "<string>",
"message": "<string>",
"data": "<unknown>"
}Conversations
List conversations
Retrieve a list of conversations with optional filtering by date ranges.
GET
/
conversations
List conversations
curl --request GET \
--url https://api.operator.xyz/conversations \
--header 'Authorization: Bearer <token>' \
--header 'Operator-Version: <operator-version>'import requests
url = "https://api.operator.xyz/conversations"
headers = {
"Operator-Version": "<operator-version>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'Operator-Version': '<operator-version>', Authorization: 'Bearer <token>'}
};
fetch('https://api.operator.xyz/conversations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"id": "<string>",
"agent_id": "<string>",
"livemode": true,
"created_at": "2023-11-07T05:31:56Z",
"direction": "inbound",
"status": "queued",
"custom_fields": {},
"customer_id": null,
"channel_type": null,
"started_at": null,
"completed_at": null,
"failure_reason": null,
"duration_sec": null,
"sentiment": null
}
],
"cursor": null
}{
"code": "<string>",
"message": "<string>",
"data": "<unknown>"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
The API version to use.
Available options:
2025-06-19 Query Parameters
Cursor to paginate through the conversations.
Filter conversations created after this date.
Filter conversations created before this date.
Filter conversations completed after this date.
Filter conversations completed before this date.

