List Conversations

curl "https://api.whatbot.in/public/v1/conversations?limit=50" \
  -H "X-API-Key: wa_live_xxx"

Query parameters

Field	Type	Required	Description
limit	number		Max conversations to return (max 200). Defaults to `50`.

There is no offset or cursor: this returns the limit most recently active conversations. Conversations that have never had a message sort last, newest first.

Response

Field	Type	Required	Description
conversations	array		The conversations, each with the fields below.

Each conversation carries:

Field	Type	Description
id	string	The conversation id. Use it with List Messages.
phone_number	string	The customer’s number, digits only (no `+`). Masked if your workspace masks the public API.
contact_name	string	The name shown in the inbox, or `null`.
status	string	`open` or `closed`.
last_message_at	string	When the last message (either direction) was sent or received.
last_inbound_at	string	When the customer last messaged — the start of the current 24-hour window.
last_message_preview	string	A short preview of the last message.
unread_count	number	Unread inbound messages.
phone_number_id	string	Which of your WhatsApp numbers this conversation is on.
contact_id	string	The linked contact, or `null`.
lead_id	string	A linked lead id, or `null`.
lead_name	string	That lead’s name, or `null`.
ext_lead_id	string	The external lead reference pushed with the contact, or `null`.
created_at	string	When the conversation was created.

{
  "conversations": [
    {
      "id": "a5230fa7-...",
      "phone_number": "919876543210",
      "contact_name": "Ravi Kumar",
      "status": "open",
      "last_message_at": "2026-07-08T09:12:00+00:00",
      "last_inbound_at": "2026-07-08T09:10:41+00:00",
      "last_message_preview": "Thanks! Your order ships today.",
      "unread_count": 0,
      "phone_number_id": "1066...",
      "contact_id": "4f1c...",
      "lead_id": null,
      "lead_name": null,
      "ext_lead_id": null,
      "created_at": "2026-07-01T11:02:13+00:00"
    }
  ]
}