Agent-readable docs index: /docs/llms.txt. Full docs in one file: /docs/llms-full.txt. Download /docs/docs.zip to grep all markdown files locally.

Get request

/sender_id_requests/{id}GET
Returns details and per-carrier statuses for a single Sender ID request.
Authorization
BearerAuth *Bearer <token>
API key generated under Account Settings → API Keys (rk_live_...). Send as header Authorization: Bearer <key>.
Response
200 · Sender ID request details
success?boolean
Example: true
data?object
Show 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"
404 · Sender ID request not found
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/5" \
  -H "Authorization: Bearer <token>"
Response example
{
  "success": false,
  "error": "Invalid, expired, or revoked API key.",
  "error_code": "unauthorized"
}