Get a contact's profile
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.
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.
Authorization
bearerAuth Per-user API token (UUID v4) sent as Authorization: Bearer <token>. Identifies the tenant and user.
In: header
Query Parameters
Contact JID. Either jid or number is required.
Phone number in international format. Used when jid is omitted.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/contacts/profile?jid=5511999999999%40s.whatsapp.net&number=5511999999999"{ "success": true, "data": { "jid": "5511999999999@s.whatsapp.net", "user_info": { "Status": "Hey there! I am using WhatsApp.", "PictureID": "1718000000", "Devices": [ "5511999999999@s.whatsapp.net" ], "VerifiedName": null }, "business_profile": null }}{ "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"}{ "success": false, "error": "validation failed", "error_code": "VALIDATION_ERROR", "timestamp": "2026-06-15T12:00:00Z"}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.
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.