API referenceWhatsapp chats
GET
/whatsapp/api/v1/chats/{id}

With its last message (lastMessage).

Authorization

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.

Lengthlength <= 4096

Response 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"  }}