List requests

/sender_id_requestsGET

Retrieves all registered SMS Sender ID requests and their per-carrier approval statuses.

Authorization

BearerAuth *Bearer <token>

API key generated under Account Settings → API Keys (rk_live_...). Send as header Authorization: Bearer <key>.

Query Parameters

status?"pending" | "approved" | "rejected"

Filter requests by status (e.g. pending, approved, rejected)

Example: "pending"

Response

200 · Sender ID requests list

success?boolean

Example: true

data?object[]

Show item properties

id?integer

Example: 5

tracking_id?string

Example: "sid_938472"

requested_sender_id?string

Example: "MYBRAND"

transactional_sender_id?string

Example: "MYBRAND"

promotional_sender_id?string

Example: "MYBRANDPROMO"

sms_type?string

Example: "transactional"

carriers?string[]

sms_types?string[]

carrier_statuses?object

approved_carriers?string[]

rejected_carriers?string[]

status?"pending" | "approved" | "rejected"

Example: "pending"

admin_notes?string | null

approved_at?string (date-time) | null

rejected_at?string (date-time) | null

created_at?string (date-time)

Example: "2026-07-22T14:00:00Z"

updated_at?string (date-time)

Example: "2026-07-22T14:00:00Z"

401 · Unauthorized

success *boolean

Example: false

error *string

Human-readable error message explaining the failure reason.

Example: "Recipient not reachable on WhatsApp."

error_code *string

Stable machine-readable error code.

Example: "recipient_not_on_whatsapp"

Request example

curl -X GET "https://convert.ruut.chat/api/v1/sender_id_requests" \
  -H "Authorization: Bearer <token>"

Response example

{
  "success": false,
  "error": "Invalid, expired, or revoked API key.",
  "error_code": "unauthorized"
}