WhatsApp Gateway
API referenceAdmin

List sessions across all organizations (super_admin)

GET
/api/v1/admin/sessions

Return all sessions across all organizations for platform admins.

Read-only route.

Requires a login JWT with role super_admin.

Only login-based super admins are accepted. Api-keys and org roles return forbidden (403).

Returns a flat list of session rows.

Authorization

AuthorizationBearer <token>

Send Authorization: Bearer <token>. The token can be a login JWT from the frontend or an api-key for a script. JWT access comes from the person's organization role. Api-key access comes from the permissions saved on the key.

In: header

Response Body

application/json

application/json

curl -X GET "https://example.com/api/v1/admin/sessions"
{  "data": [    {      "autoRead": false,      "createdAt": 1719662400000,      "createdByUserId": "user_01J9DEF...",      "gatewayId": "gw-sg-1",      "id": "01J9ZX8K2QHV0M3T6R7P4N5W8C",      "isAdminSession": false,      "label": "Support line",      "lastConnectedAt": 1719662400000,      "organizationId": "org_01J9ABC...",      "phoneNumber": "6281234567890",      "presenceTyping": true,      "ratePerHour": 600,      "ratePerMin": 20,      "status": "working",      "updatedAt": 1719662400000,      "waJid": "6281234567890@s.whatsapp.net",      "waLid": "205227043110953@lid"    }  ],  "nextCursor": "string"}
{  "error": {    "code": "not_found",    "details": {      "property1": null,      "property2": null    },    "message": "session not found"  }}