Resolve contact identifiers
Resolves a batch of identifiers (phone numbers, PN JIDs, or LID JIDs) into the best-known contact identity, mapping LIDs to phone-number JIDs and enriching with stored contact names. Optionally scoped to a group's participant list. Up to 160 inputs per call.
Resolves a batch of identifiers (phone numbers, PN JIDs, or LID JIDs) into the best-known contact identity, mapping LIDs to phone-number JIDs and enriching with stored contact names. Optionally scoped to a group's participant list. Up to 160 inputs per call.
Authorization
bearerAuth 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 identifiers to resolve into contact identities.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/contacts/resolve" \ -H "Content-Type: application/json" \ -d '{ "jids": [ "5511999999999", "5511888888888@s.whatsapp.net", "112233445566778@lid" ], "group_jid": "120363039000000000@g.us" }'{ "success": true, "count": 2, "items": [ { "input": "5511999999999", "input_jid": "5511999999999@s.whatsapp.net", "resolved_jid": "5511999999999@s.whatsapp.net", "jid": "5511999999999@s.whatsapp.net", "phone_number": "5511999999999", "full_name": "Maria Silva", "push_name": "Maria" }, { "input": "112233445566778@lid", "input_jid": "112233445566778@lid", "resolved_jid": "5511888888888@s.whatsapp.net", "jid": "5511888888888@s.whatsapp.net", "phone_number": "5511888888888", "lid_jid": "112233445566778@lid", "full_name": "Joao Pereira" } ]}{ "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"}List synced contacts GET
Returns every contact mirrored into the WUTS device app-state store, including display names and business names. Requires a connected WhatsApp session on the authenticated WUTS device.
Unblock a contact POST
Removes a contact from 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.