GET/api/v2/whatsapp-web/sessions

List WhatsApp Web sessions

Sessions linked to your account. Use accountId (session name) in send and chat list calls. System and presence-probe sessions are excluded. No QR or secrets.

When to use it. To get accountId before listing chats or sending.

Code example

Correct: Session list

curl --location 'https://raselsms.com/api/v2/whatsapp-web/sessions' \--header 'X-API-Key: YOUR_API_KEY'

Response example

200 — Session list

{  "success": true,  "data": {    "sessions": [      {        "accountId": "session-user-whatsapp-1",        "displayName": "Sales WhatsApp",        "status": "active",        "connectionState": "ready",        "moduleType": "whatsapp_web"      }    ]  }}

401 — Missing or invalid API key.

{  "success": false,  "requestId": "msgreq_1739012345678_abc123",  "code": "UNAUTHORIZED",  "error": "Missing or invalid API key"}

403 — Phone is not verified or the key lacks permission (usually messages:create or api_keys:read).

{  "success": false,  "requestId": "msgreq_1739012345678_abc123",  "code": "FORBIDDEN",  "error": "Phone not verified or missing permission"}

429 — Rate limit exceeded. Honor Retry-After when present.

{  "success": false,  "requestId": "msgreq_1739012345678_abc123",  "code": "RATE_LIMITED",  "error": "Rate limit exceeded",  "retryAfterSeconds": 30}

HTTP request

GET /api/v2/whatsapp-web/sessions

Request Headers

Header	Type	Description
X-API-Key	string	Your Rasel API key. Send it on every documented request except inbound webhooks. *

Response Fields

Field	Type	Description	Example
success	boolean	True when the operation succeeded, or when at least one batch recipient succeeded.
data	json	Primary payload for list and snapshot endpoints.

Status Codes

Status	Description
200	Success.
401	Missing or invalid API key.
403	Phone not verified, missing permission, or the account cannot perform this action.
429	Rate limit exceeded, or the maximum number of verification attempts was reached.

Try it

API Key

Request

GET /api/v2/whatsapp-web/sessions

Response

Send a request to see the response.