---
title: "Check phones"
method: POST
path: "/contacts"
tags: ["Contacts"]
---

# Check phones

`POST /contacts`

This method returns whether or not the number has Whatsapp. Batch check provisioning is supported, and there is no batch check limit. However, an atypical mass check can draw attention to your number, so we advise [balancing the check between channels](https://support.whapi.cloud/help-desk/faq/checking-if-the-number-has-whatsapp)

## Request body

- CheckContactRequest
  - `contacts` string[], required — Array of contact phone numbers. The numbers can be in any standard telephone number format.
  - `force_check` boolean — Force check determines whether the request should check the contact even if it is already in the cache.

## Response `200`

OK

- CheckContactResponse
  - `contacts` CheckContact[]
    - `input` string — The value you sent in the contacts field of the JSON request.
    - `status` 'valid' | 'invalid' — Status of the user.
    - `wa_id` string — WhatsApp user identifier that can be used in other API calls. Only returned if the status is valid.

## Other responses

- `400` — Wrong request parameters
- `401` — Need channel authorization for check phones
- `402` — Trial version limit exceeded
- `429` — Too many requests
- `500` — Internal Error

---

[API](https://skmtc.dev/whapi/apis/whatsapp-api.md) · [All operations](https://skmtc.dev/whapi/apis/whatsapp-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/whapi/whatsapp-api/revisions/40ab05abffdb/schema)