curl --request GET \
--url https://api.quo.com/conversations \
--header 'Authorization: <api-key>' \
--header 'Quo-Api-Version: <quo-api-version>'{
"data": [
{
"createdAt": "2023-11-07T05:31:56Z",
"deletedAt": "2023-11-07T05:31:56Z",
"id": "CN123abc",
"lastActivityAt": "2023-11-07T05:31:56Z",
"lastActivityId": "AC123abc",
"mutedUntil": "2023-11-07T05:31:56Z",
"name": "Chat with customer",
"participants": [
"+15555555555"
],
"phoneNumberId": "PN123abc",
"snoozedUntil": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"nextCursor": "eyJsYXN0SWQiOiJVU211a09NaXBhIn0"
}{
"message": "The input was invalid",
"docs": "https://quo.com/docs",
"title": "Bad Request",
"errors": [
{
"path": "/conversationId",
"message": "Expected string to match '^CN(.*)$'",
"value": "abc123",
"schema": {
"type": "TemplateLiteral",
"pattern": "^CN(.*)$"
}
}
]
}{
"message": "Unauthorized",
"docs": "https://quo.com/docs",
"title": "Unauthorized",
"trace": "6897907457496870895"
}{
"message": "User is forbidden to perform this action",
"docs": "https://quo.com/docs",
"title": "Forbidden",
"trace": "6897907457496870895"
}{
"message": "Conversation not found",
"docs": "https://quo.com/docs",
"title": "Not Found",
"trace": "6897907457496870895"
}{
"message": "We have encountered an unknown error",
"docs": "https://quo.com/docs",
"title": "Unknown",
"trace": "6897907457496870895"
}List conversations
Get a paginated list of the organization’s conversations, most recently created first.
curl --request GET \
--url https://api.quo.com/conversations \
--header 'Authorization: <api-key>' \
--header 'Quo-Api-Version: <quo-api-version>'{
"data": [
{
"createdAt": "2023-11-07T05:31:56Z",
"deletedAt": "2023-11-07T05:31:56Z",
"id": "CN123abc",
"lastActivityAt": "2023-11-07T05:31:56Z",
"lastActivityId": "AC123abc",
"mutedUntil": "2023-11-07T05:31:56Z",
"name": "Chat with customer",
"participants": [
"+15555555555"
],
"phoneNumberId": "PN123abc",
"snoozedUntil": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"nextCursor": "eyJsYXN0SWQiOiJVU211a09NaXBhIn0"
}{
"message": "The input was invalid",
"docs": "https://quo.com/docs",
"title": "Bad Request",
"errors": [
{
"path": "/conversationId",
"message": "Expected string to match '^CN(.*)$'",
"value": "abc123",
"schema": {
"type": "TemplateLiteral",
"pattern": "^CN(.*)$"
}
}
]
}{
"message": "Unauthorized",
"docs": "https://quo.com/docs",
"title": "Unauthorized",
"trace": "6897907457496870895"
}{
"message": "User is forbidden to perform this action",
"docs": "https://quo.com/docs",
"title": "Forbidden",
"trace": "6897907457496870895"
}{
"message": "Conversation not found",
"docs": "https://quo.com/docs",
"title": "Not Found",
"trace": "6897907457496870895"
}{
"message": "We have encountered an unknown error",
"docs": "https://quo.com/docs",
"title": "Unknown",
"trace": "6897907457496870895"
}Authorizations
Headers
API version header. Supported values: 2026-03-30
2026-03-30 Query Parameters
Only return conversations on this Quo phone number ID, such as phoneNumberId=PN123abc. To match any of several, use phoneNumberId[in]=PN123abc,PN456def (max 100). Matches the Quo phone number only, not participant numbers.
^PN(.*)$"PN123abc"
Bound the results by creation time (inclusive), in ISO 8601 format: createdAt[gte]=2022-01-01T00:00:00Z&createdAt[lte]=2022-02-01T00:00:00Z.
Show child attributes
Show child attributes
Bound the results by last-updated time (inclusive), in ISO 8601 format: updatedAt[gte]=2022-01-01T00:00:00Z&updatedAt[lte]=2022-02-01T00:00:00Z.
Show child attributes
Show child attributes
A single field:direction pair. Allowed fields: createdAt, updatedAt. Direction must be asc or desc.
"createdAt:desc"
Max number of items to return per page.
1 <= x <= 50"eyJsYXN0SWQiOiJVU211a09NaXBhIn0"
Was this page helpful?