GET/api/v2/official-senders
List official WhatsApp senders
Approved official WhatsApp numbers for the API key owner. Use officialSenderId or sender.officialId on send. approvedOnly=true returns only enabled senders.
When to use it. Pick officialSenderId or sender.officialId.
Code example
Correct: Senders ready to send
curl --location 'https://raselsms.com/api/v2/official-senders' \--header 'X-API-Key: YOUR_API_KEY'Response example
200 — Senders ready to send
{ "success": true, "data": { "officialSenders": [ { "id": "6800off123def4567890aaaa", "label": "SAWA", "displayName": "SAWA · 9613284927", "phoneNumber": "+9613284927", "status": "approved", "enabled": true, "isDefault": true, "verifiedName": "SAWA" } ] }}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/official-senders
Request Headers
| Header | Type | Description |
|---|---|---|
| X-API-Key | string | Your Rasel API key. Send it on every documented request except inbound webhooks. * |
Query parameters
| Field | Type | Description |
|---|---|---|
| approvedOnly | boolean | When true, only approved (and for official senders, enabled) rows are returned. |
Response Fields
| Field | Type | Description | Example |
|---|---|---|---|
| success | boolean | True when the operation succeeded, or when at least one batch recipient succeeded. | |
| data | object | Primary payload for list and snapshot endpoints. | |
| data.officialSenders | json | Official WhatsApp numbers on this account. |
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
Parameters
When true, only approved (and for official senders, enabled) rows are returned.
Request
GET /api/v2/official-sendersResponse
Send a request to see the response.