---
title: "List WhatsApp accounts"
method: GET
path: "/whatsapp/accounts"
tags: ["whatsapp"]
---

# List WhatsApp accounts

`GET /whatsapp/accounts`

Retrieves all WhatsApp accounts associated with your user.

**Permission:** Access is managed by the WhatsApp service. No specific API token permission is checked.

**Monitoring:** No impact.

## Response `200`

Successful operation — returns the list of WhatsApp accounts.

- WhatsappAccount[]
  - `account_name` string
  - `account_namespace` string
  - `account_number` integer
  - `account_uuid` string, uuid
  - `application_id` string, uuid
  - `creation_date` string, date-time
  - `status` string
  - `team_id` integer
  - `update_date` string, date-time
  - `users` integer[]
  - `uuid` string, uuid
  - `waba_id` string

## Other responses

- `401` — Unauthorized — access denied by the WhatsApp service.
- `404` — Not found — no WhatsApp accounts found for the user.
- `500` — Internal server error.

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)
