# 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.







```shell
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.