curl --request GET \
--url https://api.quo.com/v1/conversations \
--header 'Authorization: <api-key>'{
"data": [
{
"assignedTo": "US123abc",
"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"
}
],
"totalItems": 123,
"nextPageToken": "<string>"
}{
"message": "<string>",
"code": "1000400",
"status": 400,
"docs": "https://quo.com/docs",
"title": "Bad Request",
"trace": "<string>",
"errors": [
{
"path": "<string>",
"message": "<string>",
"schema": {
"type": "<string>"
},
"value": "<unknown>"
}
]
}{
"error": {
"message": "<string>",
"key": "Unauthorized",
"trace": "<string>"
}
}{
"message": "<string>",
"code": "1000403",
"status": 403,
"docs": "https://quo.com/docs",
"title": "Forbidden",
"trace": "<string>",
"errors": [
{
"path": "<string>",
"message": "<string>",
"schema": {
"type": "<string>"
},
"value": "<unknown>"
}
]
}{
"message": "<string>",
"code": "1000404",
"status": 404,
"docs": "https://quo.com/docs",
"title": "Not Found",
"trace": "<string>",
"errors": [
{
"path": "<string>",
"message": "<string>",
"schema": {
"type": "<string>"
},
"value": "<unknown>"
}
]
}{
"message": "<string>",
"code": "1000500",
"status": 500,
"docs": "https://quo.com/docs",
"title": "Unexpected",
"trace": "<string>",
"errors": [
{
"path": "<string>",
"message": "<string>",
"schema": {
"type": "<string>"
},
"value": "<unknown>"
}
]
}List conversations
Fetch a paginated list of conversations of Quo conversations. Can be filtered by user and/or phone numbers. Defaults to all conversations in the Quo organization. Results are returned in descending order based on the most recent conversation.
curl --request GET \
--url https://api.quo.com/v1/conversations \
--header 'Authorization: <api-key>'{
"data": [
{
"assignedTo": "US123abc",
"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"
}
],
"totalItems": 123,
"nextPageToken": "<string>"
}{
"message": "<string>",
"code": "1000400",
"status": 400,
"docs": "https://quo.com/docs",
"title": "Bad Request",
"trace": "<string>",
"errors": [
{
"path": "<string>",
"message": "<string>",
"schema": {
"type": "<string>"
},
"value": "<unknown>"
}
]
}{
"error": {
"message": "<string>",
"key": "Unauthorized",
"trace": "<string>"
}
}{
"message": "<string>",
"code": "1000403",
"status": 403,
"docs": "https://quo.com/docs",
"title": "Forbidden",
"trace": "<string>",
"errors": [
{
"path": "<string>",
"message": "<string>",
"schema": {
"type": "<string>"
},
"value": "<unknown>"
}
]
}{
"message": "<string>",
"code": "1000404",
"status": 404,
"docs": "https://quo.com/docs",
"title": "Not Found",
"trace": "<string>",
"errors": [
{
"path": "<string>",
"message": "<string>",
"schema": {
"type": "<string>"
},
"value": "<unknown>"
}
]
}{
"message": "<string>",
"code": "1000500",
"status": 500,
"docs": "https://quo.com/docs",
"title": "Unexpected",
"trace": "<string>",
"errors": [
{
"path": "<string>",
"message": "<string>",
"schema": {
"type": "<string>"
},
"value": "<unknown>"
}
]
}Query Parameters
DEPRECATED, use phoneNumbers instead. If both phoneNumber and phoneNumbers are provided, phoneNumbers will be used. Filters results to only include conversations with the specified Quo phone number. Can be either your Quo phone number ID or the full phone number in E.164 format.
^\+[1-9]\d{1,14}$"+15555555555"
Filters results to only include conversations with the specified Quo phone numbers. Each item can be either an Quo phone number ID or a full phone number in E.164 format.
1 - 100 elementsA phone number in E.164 format, including the country code.
^\+[1-9]\d{1,14}$"+15555555555"
["+15555555555", "PN123abc"]
Was this page helpful?