List messages

GET

/api/v1/messages

List all messages for the account. Supports filtering by direction, date, and business phone number.

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/messages?page=1&per=50&direction&created_after&created_before&business_phone_number=919876543210' \
--header 'Authorization: <api-key>'

Responses

🟢200Success

application/json

A paginated list of messages

Body

Example

{
    "count": 1,
    "next": null,
    "previous": null,
    "messages": [
        {
            "id": "msg_123",
            "external_id": "wa_456",
            "direction": "outbound",
            "text": "Hello, how can I help you?",
            "content_type": "text",
            "status": "sent",
            "channel": "whatsapp",
            "conversation_id": 789,
            "created_at": "2025-05-20T10:00:00Z",
            "phone_number": {
                "number": "+919876543210",
                "display_name": "Peach Support"
            },
            "author": {
                "type": "user",
                "name": "Jane Doe",
                "email": "jane@example.com"
            }
        }
    ]
}

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

Fetch template details

List conversations