Skip to main content

​
List WhatsApp Messages

GET/v1/whatsapp
Get a paginated list of WhatsApp messages.

​
Query Parameters

ParameterTypeDescription
pagenumberPage number (default: 1)
limitnumberResults per page (default: 50, max: 100)
statusstringFilter by status: pending, sent, delivered, read, failed
tostringFilter by recipient phone number

​
Example

cURL
curl "https://www.unosend.co/api/v1/whatsapp?page=1&limit=20&status=delivered" \
  -H "Authorization: Bearer un_your_api_key"

​
Response

200 OK
{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "from": "+14155551234",
      "to": "+919876543210",
      "type": "template",
      "template_name": "order_update",
      "message": null,
      "status": "delivered",
      "transaction_id": "txn_abc123",
      "sent_at": "2026-01-15T10:30:00.000Z",
      "delivered_at": "2026-01-15T10:30:05.000Z",
      "read_at": null,
      "error": null,
      "created_at": "2026-01-15T10:30:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 45,
    "pages": 3
  }
}

​
Message Status

StatusDescription
pendingMessage queued for sending
sentMessage sent to WhatsApp
deliveredMessage delivered to recipient’s device
readMessage read by recipient
failedMessage failed to send