List conversations
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.
curl -X GET 'https://api.whatsable.app/v1/conversations'
Lists the conversations on the numbers this key may use, the latest last_message_at first. The order changes as messages arrive, so paging can skip or repeat a conversation. To follow changes, poll with updated_after.
bearerAuthAuthorizationBearer <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.
1 <= value <= 10025cursor?stringThe next_cursor of the previous page. An expired or malformed cursor answers 400 invalid_cursor.
1 <= length <= 512number_id?string1 <= length <= 64contact_id?string1 <= length <= 64updated_after?stringOnly conversations updated after this instant. For polling.
date-timeA page of conversations, the latest message 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/conversations'{ "object": "list", "data": [ { "object": "conversation", "id": "cm2v8c1a00001qz8h4t5u6v7w", "number_id": "cm2v8a1b20002qz8h9i0j1k2l", "contact_id": "cm2v8k1a00001qz8h8x9y0z1a", "last_message_at": "2026-10-20T19:51:21Z", "last_inbound_at": "2026-10-20T18:00:00Z", "window_expires_at": "2026-10-21T18:00:00Z", "window_open": true, "unread_count": 2, "ai": { "bot_id": "cm2v8b1a00001qz8h3j4k5l6m", "status": "active" }, "created_at": "2026-09-01T12:00:00Z", "updated_at": "2026-10-20T19:51:21Z" } ], "has_more": true, "next_cursor": "string"}Upload a file to send by its id POST
Uploads one file. For 30 days, you can send it by its `id` from any number this key may use. Send a `multipart/form-data` body with one `file` part.
Read a conversation and its 24-hour window GET
Returns a conversation and the state of its 24-hour window. Check `window_open` before you send a session message. Reading a conversation does not mark its messages as read.