---
title: "List all WhatsApp numbers"
method: POST
path: "/whatsapp/accounts/"
tags: ["WhatsApp numbers"]
---

# List all WhatsApp numbers

`POST /whatsapp/accounts/`

## Request

- Base URL: `https://wbiztool.com/api/v1`
- URL: `https://wbiztool.com/api/v1/whatsapp/accounts/`
- Auth: none required

Every WhatsApp number of the workspace that has not been deleted, connected or not, sorted by ID. A successful response has no `message` field.

## Request body

- Credentials: Your API credentials, sent in the request body (JSON or form fields) of every request that uses them. Both come from Settings → API keys in the dashboard. The API key decides which workspace the request acts on.
  - `client_id` integer, required: Your API Client ID from Settings → API keys.
  - `api_key` string, required: One of your API keys from the same page. Keep it secret.

## Response `200`

The numbers.

- WhatsappAccounts
  - `status` 1, required
  - `whatsapp_clients` object[], required
    - `whatsapp_client_id` integer
    - `whatsapp_number` string
    - `status` 'connected' | 'not_connected'

## Other responses

- `400`: Refused: `Auth Error - Please send correct API key and Client id`, `Invalid client id.`, `Auth Error: invalid api key`, or `This API key is not linked to a workspace. Create a new API key in WbizTool.`
- `405`: Not a POST request.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/wbiztool/apis/wbiztool-api.md) · [All operations](https://skmtc.dev/wbiztool/apis/wbiztool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wbiztool/apis/wbiztool-api/revisions/bc7380bb5684?raw)