// Endpoints
Conversations
Read conversations and the messages inside them.
Each contact has one conversation: the thread your team sees in the inbox. These endpoints only read. To send, use messages; to be told about new messages without polling, use webhooks.
GET
/api/v1/conversationsList conversations
Scope: conversations:read
Newest activity first, paginated. Each row includes its contact and the contact's tags.
| Query | Values |
|---|---|
status | open, pending or closed |
contact_id | One contact's conversation |
limit | 1–100, default 50 |
cursor | From the previous page |
curl "https://whatsapp.esendblue.com/api/v1/conversations?status=open" \
-H "Authorization: Bearer wacrm_live_YOUR_KEY"GET
/api/v1/conversations/{id}Read a conversation
Scope: conversations:read
One conversation. Returns 404 if it belongs to another project.
GET
/api/v1/conversations/{id}/messagesList a conversation's messages
Scope: messages:read
Newest first, paginated. direction is inbound or outbound; status is the delivery state of an outbound message: sending, sent, delivered, read or failed.
curl "https://whatsapp.esendblue.com/api/v1/conversations/CONVERSATION_ID/messages?limit=20" \
-H "Authorization: Bearer wacrm_live_YOUR_KEY"