GET/api/v2/sms-senders
List SMS sender names
Sender names for the account. Use approvedOnly=true before sending via /api/v2/messages/send.
When to use it. Pick sender.id for a send request.
Code example
Correct: Approved only
curl --location 'https://raselsms.com/api/v2/sms-senders' \--header 'X-API-Key: YOUR_API_KEY'Response example
200 — Approved only
{ "success": true, "data": { "smsSenders": [ { "id": "6800abc123def4567890fedc", "name": "MyBrand", "status": "approved", "isDefault": true, "reviewNote": null } ] }}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/sms-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.smsSenders | json | Approved SMS sender names 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/sms-sendersResponse
Send a request to see the response.