Contacts

Check if numbers have WhatsApp

Checks a batch of phone numbers against WhatsApp and returns a map of cleaned number to a boolean indicating whether each number is registered. Numbers are normalized (plus, dashes, spaces, and parentheses stripped) before lookup.

POST
/contact/check

Checks a batch of phone numbers against WhatsApp and returns a map of cleaned number to a boolean indicating whether each number is registered. Numbers are normalized (plus, dashes, spaces, and parentheses stripped) before lookup.

Authorization

bearerAuth
AuthorizationBearer <token>

Per-user API token (UUID v4) sent as Authorization: Bearer <token>. Identifies the tenant and user.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Batch of phone numbers to check against WhatsApp.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/contact/check" \  -H "Content-Type: application/json" \  -d '{    "numbers": [      "5511999999999",      "+55 11 88888-8888"    ]  }'
{  "success": true,  "data": {    "5511999999999": true,    "5511888888888": false  }}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}

Block a contact POST

Adds a contact to the WhatsApp block list of the authenticated WUTS device. Provide the target as a JID or a phone number in the body or query string; WUTS resolves the LID/PN identity automatically.

Get the WhatsApp block list GET

Returns the current WhatsApp block list for the authenticated WUTS device, with each blocked contact's normalized JID and phone number plus the server delta hash.