Get a contact profile picture
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.
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.
Authorization
bearerAuth Per-user API token (UUID v4) sent as Authorization: Bearer <token>. Identifies the tenant and user.
In: header
Query Parameters
Contact or group JID. Either jid or number is required.
Phone number used when jid is not supplied. Either jid or number is required.
When false (or 0) returns the full-resolution image instead of the low-res preview.
Known picture id; if it still matches, the response is flagged unchanged with a null url.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/contacts/profile-picture"{ "success": true, "data": { "jid": "5511999999999@s.whatsapp.net", "url": "https://pps.whatsapp.net/v/t61.24694-24/abc123.jpg", "id": "1700000000", "type": "image", "direct_path": "/v/t61.24694-24/abc123.jpg" }}{ "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 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.
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.