Contacts

Get the WhatsApp block list

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.

GET
/contacts/blocklist

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.

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/contacts/blocklist"
{  "success": true,  "data": {    "items": [      {        "jid": "5511999999999@s.whatsapp.net",        "phone_number": "5511999999999"      }    ],    "count": 1,    "dhash": "2:abc123def456"  }}
{  "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"}
{  "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"}

Check if numbers have WhatsApp POST

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.

Get a contact's profile GET

Returns a contact's user info (status text, profile picture ID, linked devices, verified business name) and, when the contact is a WhatsApp Business account, its business profile. The contact is addressed with a jid (or number) query parameter, matching the GET /contacts/profile-picture convention.