> ## Documentation Index
> Fetch the complete documentation index at: https://docs.robase.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# SMS overview

> Programmable SMS across every African MNO through one API.

Robase SMS delivers to MTN, Airtel, Glo, 9mobile, Safaricom, MPesa-numbered MNOs, Orange, and every carrier our upstream partners reach — through one REST endpoint.

## What makes it different

<CardGroup cols={2}>
  <Card title="Multi-country by default" icon="earth-africa" href="/sms/multi-country">
    NG · GH · KE · CI today. Country is auto-detected from the E.164 number.
  </Card>

  <Card title="Provider failover" icon="shuffle" href="/sms/providers">
    Primary carrier down? We fail over automatically and log every attempt.
  </Card>

  <Card title="Test mode with DLRs" icon="flask" href="/sms/test-mode">
    Magic numbers produce delivered / failed / slow / DND. Zero cost.
  </Card>

  <Card title="Templates with variables" icon="code" href="/sms/templates">
    `{{.driver_name}}` placeholders rendered server-side.
  </Card>
</CardGroup>

## How a send works

<Steps>
  <Step title="POST /v1/sms">
    Your request is validated (E.164, sender ID, body length) and assigned a message ID.
  </Step>

  <Step title="Billed">
    Wallet is reserved for overage (or covered by your plan's monthly allowance). Country determines the rate.
  </Step>

  <Step title="Queued">
    Message is persisted and a background job is enqueued. Response returns `status: "queued"` immediately.
  </Step>

  <Step title="Routed">
    Worker picks the provider chain for the destination country, attempts each in order until one accepts. Every attempt is logged.
  </Step>

  <Step title="Delivered">
    Upstream carrier posts a delivery report to our DLR endpoint. We correlate, update status, and fire your webhook.
  </Step>
</Steps>

## Pricing

Billing is per-segment (160 GSM-7 chars or 70 UCS-2 chars = 1 segment). Your plan includes a monthly allowance; overage is debited from your wallet at per-country rates.

| Country            | Pro plan rate      | Scale plan rate    |
| ------------------ | ------------------ | ------------------ |
| Nigeria (NG)       | ₦4.00 / segment    | ₦3.50 / segment    |
| Ghana (GH)         | GH₵ 0.15 / segment | GH₵ 0.12 / segment |
| Kenya (KE)         | KSh 1.20 / segment | KSh 1.00 / segment |
| Côte d'Ivoire (CI) | XOF 25 / segment   | XOF 22 / segment   |

See [Multi-country](/sms/multi-country) for the full table and currency handling.

## Start here

<CardGroup cols={2}>
  <Card title="Send your first SMS" icon="play" href="/sms/sending">
    Full send API with all options explained.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/sms/send">
    Live playground for `POST /v1/sms`.
  </Card>
</CardGroup>