API ReferenceConnections
List Connections
List all WhatsApp connections for the authenticated user.
GET /api/connections
Returns an array of all active connections belonging to the authenticated user. Connections with status stopped (soft-deleted) are excluded from the results.
Authentication
| Header | Type | Required | Description |
|---|---|---|---|
Authorization | string | Yes | Bearer token. Format: Bearer <token> |
Response
[
{
"id": "c1a2b3c4-d5e6-7f89-0abc-def123456789",
"userId": "your-user-id",
"workerId": "w9a8b7c6-d5e4-3f21-0fed-cba987654321",
"sessionName": "u_a80ffc98_s_c1a2b3c4",
"phoneNumber": "+1234567890",
"status": "connected",
"engine": "NOWEB",
"createdAt": "2026-03-14T10:00:00.000Z",
"updatedAt": "2026-03-14T10:05:00.000Z"
},
{
"id": "d2b3c4d5-e6f7-8901-bcde-f12345678901",
"userId": "your-user-id",
"workerId": "w9a8b7c6-d5e4-3f21-0fed-cba987654321",
"sessionName": "u_a80ffc98_s_d2b3c4d5",
"phoneNumber": null,
"status": "scan_qr",
"engine": "NOWEB",
"createdAt": "2026-03-14T11:00:00.000Z",
"updatedAt": "2026-03-14T11:00:00.000Z"
}
]{
"statusCode": 401,
"message": "Unauthorized"
}