API referenceWhatsapp attendees
GET
/whatsapp/api/v1/chat_attendees

The people the numbers talk to (their contacts as WhatsApp reports them, and anyone they messaged), from Swarmhit's stored contacts, newest first. Numbers known not to be on WhatsApp are left out.

Authorization

X-API-KEY<token>

Your API key from the console (gw_live_…).

In: header

Query Parameters

account_id?string

Only these accounts: one wa_… id, or several separated by commas.

Lengthlength <= 4096
limit?integer

Items per page, 1 to 250. Default 100.

Range1 <= value <= 250
Default100
cursor?string

The cursor the previous page answered, passed back unchanged, for the next page (newest first). Leave it out for the first page; a null cursor means there is no next page. Keep the same filters from page to page: a page never skips or repeats an item that arrives meanwhile.

Lengthlength <= 200
before?string

Only items strictly older than this date: ISO 8601 with a time zone, e.g. 2026-10-31T00:00:00Z. A value that is not a date answers 400.

Lengthlength <= 40
after?string

Only items strictly newer than this date: ISO 8601 with a time zone, e.g. 2026-10-31T00:00:00Z. A value that is not a date answers 400.

Lengthlength <= 40

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/whatsapp/api/v1/chat_attendees?account_id=wa_Xk2pQ9rT4vW8yZ1a"
{  "object": "ChatAttendeeList",  "items": [    {      "object": "ChatAttendee",      "id": "waa_H5gT8kL2mQ9wR3vB",      "account_id": "wa_Xk2pQ9rT4vW8yZ1a",      "provider_id": "33612345678@s.whatsapp.net",      "name": "Jane Doe",      "is_self": 0,      "hidden": 0,      "profile_url": "https://wa.me/33612345678"    }  ],  "cursor": null}