---
title: "WhatsApp Numbers"
method: POST
path: "/chat/whatsappNumbers/{instance}"
tags: ["Chat Controller"]
---

# WhatsApp Numbers

`POST /chat/whatsappNumbers/{instance}`

## Request

- Base URL: `https://evolution-example`
- URL: `https://evolution-example/chat/whatsappNumbers/{instance}`
- Auth: API key in header `apikey`

Check if numbers are on WhatsApp

## Path parameters

- `instance` string, required

## Request body

- object
  - `numbers` string[]: Phone numbers (with country code) to be checked

## Response `200`

Ok

- object[]: Array of objects representing WhatsApp account existence information.
  - `exists` boolean: Indicates whether the WhatsApp account exists.
  - `jid` string: The JID of the WhatsApp account.
  - `number` string: The phone number associated with the WhatsApp account.

## Changes

- **2024-11-25** (v2) `c153448703e5`: 5 info
  - api operation id `whatsappNumbers` was added
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - api tag `Chat Controller` added
  - api tag `Chat` removed
  - …1 more
- **2024-09-09** (v2) `0c4620ca5ed5`: 1 warning, 4 info
  - removed the request property `numbers`
  - api operation id `whatsappNumbers` removed and replaced with ``
  - the endpoint scheme security `ApiKeyAuth` was removed from the API
  - api tag `Chat` added
  - …1 more

[Operation history](https://skmtc.dev/evolution-foundation/apis/evolution-api-3/changes/chat/whatsappNumbers/:instance/post.md)

---

[API](https://skmtc.dev/evolution-foundation/apis/evolution-api-3.md) - [All operations](https://skmtc.dev/evolution-foundation/apis/evolution-api-3/llms.txt) - [OpenAPI document](https://skmtc.dev/evolution-foundation/apis/evolution-api-3/revisions/153363ee7f38?raw)