List my devices
Returns every WUTS device (WhatsApp instance) registered to the authenticated user. The user is resolved from the bearer token, so no parameters are required.
Returns every WUTS device (WhatsApp instance) registered to the authenticated user. The user is resolved from the bearer token, so no parameters are required.
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
curl -X GET "https://example.com/devices"{ "success": true, "devices": [ { "id": "d3f1a2b4-7c6e-4f01-9a2b-1c2d3e4f5a6b", "user_id": "9b1c7e2a-44d3-4a55-8f10-2b3c4d5e6f70", "name": "Sales WhatsApp", "whatsapp_jid": "5511999999999@s.whatsapp.net", "connected": true, "last_seen": "2026-06-15T13:42:10Z", "webhook_url": "https://app.example.com/webhook", "created_at": "2026-06-01T09:00:00Z", "updated_at": "2026-06-15T13:42:10Z" } ]}{ "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"}Check QR code status GET
Reports whether a cached QR code currently exists for the given WUTS device and, when present, when it was generated. Use this to poll for an active QR before showing the pairing screen.
Log out the instance POST
Performs a full logout: clears the stored WhatsApp credentials and removes the companion device server-side. Unlike POST /disconnect (which only drops the socket and keeps credentials), the instance must be re-paired (QR or pairing code) before it can connect again. Requires a live connection.