Message History

GET /v1/whatsapp/messages

Returns a paginated list of all WhatsApp messages (both inbound and outbound) for the authenticated user. You can filter by session, direction, status, and date range.

Authentication

Header	Type	Required	Description
Authorization	string	Yes	Bearer sk_live_YOUR_API_KEY

Query Parameters

Parameter	Type	Required	Description
session_id	string	No	Filter to a specific session.
direction	string	No	in for received, out for sent.
status	string	No	accepted, delivered, read, failed.
from_date	string	No	ISO 8601 date (e.g., 2026-03-01).
to_date	string	No	ISO 8601 date (e.g., 2026-03-31).
page	integer	No	Page number (default: 1).
per_page	integer	No	Results per page (default: 25, max: 100).

cURL

curl "https://sendapi.co/v1/whatsapp/messages?direction=out&status=delivered&per_page=50" \
  -H "Authorization: Bearer sk_live_123456789"

Node.js

const messages = await client.whatsapp.messages.list({
  direction: 'out',
  status: 'delivered',
  per_page: 50
});

Python

messages = client.whatsapp.messages.list(
    direction="out",
    status="delivered",
    per_page=50
)

Response

{
  "data": [
    {
      "id": "msg_01H8...QP",
      "session_id": "sess_01H8BKF...Z2T",
      "direction": "out",
      "to": "+447700900000",
      "type": "text",
      "content": { "body": "Hello! How can our support team assist you today?" },
      "status": "delivered",
      "delivered_at": "2026-03-09T14:30:22Z",
      "created_at": "2026-03-09T14:30:00Z"
    }
  ],
  "meta": {
    "total": 1402,
    "page": 1,
    "per_page": 25,
    "last_page": 57
  }
}

---

Get a Single Message

GET /v1/whatsapp/messages/{id}

Returns the full details of a single message, including content and delivery timeline.

curl https://sendapi.co/v1/whatsapp/messages/msg_01H8...QP \
  -H "Authorization: Bearer sk_live_123456789"

Response

{
  "id": "msg_01H8...QP",
  "session_id": "sess_01H8BKF...Z2T",
  "direction": "out",
  "to": "+447700900000",
  "type": "text",
  "content": { "body": "Hello! How can our support team assist you today?" },
  "status": "read",
  "external_id": "wamid.HBgNNDQ3...",
  "cost": null,
  "timeline": {
    "accepted_at": "2026-03-09T14:30:00Z",
    "sent_at": "2026-03-09T14:30:01Z",
    "delivered_at": "2026-03-09T14:30:22Z",
    "read_at": "2026-03-09T14:31:05Z"
  },
  "created_at": "2026-03-09T14:30:00Z"
}

Message Statuses

Status	Description
accepted	Message accepted by SendAPI
sent	Delivered to WhatsApp servers
delivered	Received on recipient's device (double checkmark)
read	Opened by recipient (blue checkmark)
failed	Delivery failed