Contacts, chats, and groups
Read data available through a connected WhatsApp account using a session-scoped read key.
Available operations#
All operations require read permission, active service access, and a ready session. They expose only the connected account’s available data. They do not grant access to other TurbineWhats.app customers.
| Endpoint | Purpose |
|---|---|
| GET /channels/{id}/contacts | Read available contact data. |
| GET /channels/{id}/chats | Read available chat data. |
| GET /channels/{id}/groups | Read available group data. |
Response handling#
The current API places the gateway’s listing response under data. Listing fields vary by engine and connected account; no normalized contact/chat/group schema is guaranteed in this release.
Public pagination parameters are not implemented for these routes. Do not treat a returned list as a complete export of the account.
curl 'https://turbinewhats.app/api/v1/channels/1d848fa6-b0c2-4d28-b870-09f44d750d93/contacts' \
--header "Authorization: Bearer $TURBINEWHATS_TOKEN"Usage restrictions#
A read result does not establish recipient consent. Do not use lists for unsolicited outreach, scraping, or resale. Paid accounts can send to group IDs ending in @g.us and use the group administration API. Group permissions and participant consent still apply.