List conversations

GET

/api/v1/conversations

List conversations for the account. Supports filtering by status, escalation, activity type, and time windows.

Request

Authorization

Add parameter in header

Authorization

Example:

Authorization: ********************

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET '/api/v1/conversations?status&escalated&activity_type&activity_since&updated_since&page=1&per=50' \
--header 'Authorization: <api-key>'

Responses

🟢200Success

application/json

Paginated list of conversations

Body

Example

{
    "count": 0,
    "next": "string",
    "prev": "string",
    "conversations": [
        {
            "id": 0,
            "status": "open",
            "escalated": true,
            "can_respond_till": "2019-08-24T14:15:22.123Z",
            "subscriber": {
                "id": 0,
                "name": "string",
                "phone_number": "string"
            },
            "assigned_to": {
                "type": "string",
                "id": 0,
                "name": "string"
            },
            "last_activity_at": "2019-08-24T14:15:22.123Z",
            "updated_at": "2019-08-24T14:15:22.123Z",
            "created_at": "2019-08-24T14:15:22.123Z"
        }
    ]
}

Modified at 2026-04-21 12:14:00

List messages

Update conversation status