API referenceWhatsapp chats
With its last message (lastMessage).
X-API-KEY<token>
Your API key from the console (gw_live_…).
In: header
Path Parameters
id*string
A chat id (wac_…), or a WhatsApp JID / phone number together with account_id.
Query Parameters
account_id?string
The account the id belongs to: required when the path names a JID or a phone number instead of Swarmhit's id.
Length
length <= 4096Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/whatsapp/api/v1/chats/wac_k3J9sLq2Vx8nB4mR?account_id=wa_Xk2pQ9rT4vW8yZ1a"{ "object": "Chat", "id": "wac_k3J9sLq2Vx8nB4mR", "account_id": "wa_Xk2pQ9rT4vW8yZ1a", "account_type": "WHATSAPP", "provider_id": "33612345678@s.whatsapp.net", "attendee_provider_id": "33612345678@s.whatsapp.net", "name": "Jane Doe", "type": 0, "timestamp": "2026-10-31T09:30:00.000Z", "unread_count": 1, "archived": 0, "muted_until": null, "read_only": 0, "disabledFeatures": [], "folder": [ "INBOX" ], "pinned": 0, "lastMessage": { "id": "wam_P7tR2wQ9zL4kN8vX", "provider_id": "3EB0C431D2A1B5E6F7A8", "account_id": "wa_Xk2pQ9rT4vW8yZ1a", "chat_id": "wac_k3J9sLq2Vx8nB4mR", "chat_provider_id": "33612345678@s.whatsapp.net", "sender_id": "33612345678@s.whatsapp.net", "sender_attendee_id": "waa_H5gT8kL2mQ9wR3vB", "text": "Hi, thanks for reaching out!", "attachments": [], "timestamp": "2026-10-31T09:30:00.000Z", "is_sender": 0, "is_forwarded": false, "is_view_once": false, "reactions": [], "seen": 0, "seen_by": {}, "hidden": 0, "deleted": 0, "edited": 0, "is_event": 0, "delivered": 1, "behavior": null, "original": "", "message_type": "MESSAGE" }}