List synced contacts
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.
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.
Authorization
bearerAuth 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"{ "success": true, "count": 2, "contacts": [ { "jid": "5511999999999@s.whatsapp.net", "first_name": "Maria", "full_name": "Maria Silva", "push_name": "Maria", "business_name": "Silva Comercio" }, { "jid": "5511888888888@s.whatsapp.net", "full_name": "Joao Pereira", "push_name": "Joao" } ]}{ "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"}Get a contact profile picture GET
Fetches the profile picture URL for a contact or group via the live WUTS WhatsApp socket. Pass either a JID or a phone number; request the full image with preview=false, and pass an existing_id to short-circuit when the picture is unchanged.
Resolve contact identifiers POST
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.