# List conversations

`GET /api/v1/whatsapp/chats`

v92 (beta): conversations on the workspace's WhatsApp Business number, latest message first (max 100). Row: `id`, `phone`, `name`, `profile_name`, `company_id`, `company`, `contact_id`, `unread`, `last_at`, `last_text`, `window_open` (the customer wrote in the last 24 hours — free text can be sent), `window_ends_at`, `marketing_optin`, `url`. Response: `enabled` (connection on), `chats`, `counts` (per filter).

## Query parameters

| Field | Type | Description |
|---|---|---|
| `filter` | string | `all`, `unread`, `open` (waiting for a reply), `unlinked` (not matched to a company). Values: `all`, `unread`, `open`, `unlinked` |
| `q` | string | Name or number contains. |
| `company_id` | integer | Only this company's conversations. |