API v1Messages
List messages
gethttps://api.whatsable.app/v1/messages
Build a request to copy
This page never sends a request. Fill in the fields, then copy the request and run it from your server.
Request
curl -X GET 'https://api.whatsable.app/v1/messages'
Lists the messages on the numbers this key may use, newest first. To find new inbound messages, poll with created_after.
bearerAuthheader
AuthorizationBearer <nfy_live_<32 characters>>An API key from Settings > API keys, sent as Authorization: Bearer <key>.
limit?integerHow many items to return, 1 to 100.
Range
1 <= value <= 100Default
25cursor?stringThe next_cursor of the previous page. An expired or malformed cursor answers 400 invalid_cursor.
Length
1 <= length <= 512conversation_id?stringLength
1 <= length <= 64contact_id?stringLength
1 <= length <= 64number_id?stringLength
1 <= length <= 64direction?stringValue in
"inbound""outbound"status?stringValue in
"pending""sent""delivered""read""failed"created_after?stringOnly messages created after this instant. For polling.
Format
date-timeA page of messages, newest first.
application/json- response
object*stringdata*array<>has_more*booleanTrue when another page follows this one.
next_cursor*|Pass as cursor to read the next page. Null on the last page. Valid for 24 hours.
curl -X GET 'https://api.whatsable.app/v1/messages'Example Response
{ "object": "list", "data": [ { "object": "message", "id": "cm2v8m1a00001qz8h0p1q2r3s", "conversation_id": "cm2v8c1a00001qz8h4t5u6v7w", "contact_id": "cm2v8k1a00001qz8h8x9y0z1a", "number_id": "cm2v8a1b20002qz8h9i0j1k2l", "direction": "outbound", "type": "template", "status": "sent", "sent_by": "api", "to": { "phone": "+5491155550000", "wa_user_id": null, "username": null }, "from": null, "text": "Hi Ana, your order #1042 is on its way.", "template": { "id": "cm2v8t1a00001qz8habcd1234", "name": "order_shipped", "language": "en_US" }, "media": null, "whatsapp_message_id": "wamid.HBgMNTQ5MTE1NTU1MDAwMBUCABEYEjQ", "error": null, "created_at": "2026-10-20T19:51:21Z", "delivered_at": null, "read_at": null, "edited_at": null, "deleted_at": null, "referral": null, "button_reply": null } ], "has_more": true, "next_cursor": "string"}