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

Responses

🟢200Success

application/json

A paginated list of messages

Bodyapplication/json

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-06-03 05:10:05

Fetch template details

List conversations