Get my devices (current user)
Returns a summary of the devices belonging to the authenticated user, including connection state and last-seen timestamps, wrapped in the standard WUTS response envelope.
Returns a summary of the devices belonging to the authenticated user, including connection state and last-seen timestamps, wrapped in the standard WUTS response envelope.
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
curl -X GET "https://example.com/user/devices"{ "success": true, "data": { "devices": [ { "id": "d3f1a2b4-7c6e-4f01-9a2b-1c2d3e4f5a6b", "name": "Sales WhatsApp", "connected": true, "last_seen": "2026-06-15T13:45:00Z", "created_at": "2026-06-01T09:00:00Z" } ], "count": 1, "user_id": "9b1c7e2a-44d3-4a55-8f10-2b3c4d5e6f70" }}{ "success": false, "error": "validation failed", "error_code": "VALIDATION_ERROR", "timestamp": "2026-06-15T12:00:00Z"}Get instance send-health GET
Returns the derived **send health** of a device (WhatsApp instance) over a rolling 24-hour window, computed from the instance's real send outcomes. It surfaces WhatsApp's **reach-out time-lock**: when `restricted` is `true` (with `restriction: "reachout_timelock"`), WhatsApp is blocking this number's messages to new/cold contacts — common on new or recently re-created numbers. `available` is `false` when there is no send activity yet in the window. The device must belong to the authenticated token; ownership is enforced.
Get account privacy settings GET
Returns the connected account's own privacy settings (last seen, profile photo, status, read receipts, group-add, calls, messages, and online presence). WhatsApp only exposes the privacy settings of the linked account itself, so no contact JID is accepted.