> ## 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.

> ## Agent Instructions
> For chatbots and coding agents, start at /guides/ai-agents.
> Hosted MCP: POST https://api.robase.dev/mcp (Streamable HTTP). Auth: Authorization: Bearer robe_… or robe_agent_….
> Phase 1 tools: get_pricing, send_otp, verify_otp, get_otp, send_sms, get_sms. No payment or top-up tools.
> Call get_pricing; treat listed:true as marketed markets (NG, GH, KE, ZA, GB, BJ, CI, US). Do not invent countries or delivery percentages.
> Prefer OTP-shaped tests such as "Your Robase test OTP is 123456". Do not send Hello or Good morning as tests. Match errors on error.type.

# Robase

> SMS OTP and transactional SMS for Africa. Ship a working integration in minutes.

Robase is an SMS API for sending one-time passcodes and transactional messages across Africa — the same routing, automatic provider failover, and prepaid credits for both.

This is not a programmable-email platform. There is no public email HTTP API. Account mail (signup verification, receipts, invites) stays internal.

## Start here

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Create a key and send your first OTP or transactional SMS.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/introduction">
    The five public endpoints, with a live playground.
  </Card>

  <Card title="SDKs" icon="cube" href="/sdks/overview">
    Official clients for Node.js, Go, and PHP.
  </Card>

  <Card title="Changelog" icon="list" href="/changelog">
    What shipped, dated from git history.
  </Card>
</CardGroup>

## What you can build

<CardGroup cols={2}>
  <Card title="OTP verification" icon="shield-check" href="/guides/otp-verification">
    Send a code with `POST /v1/otp/send` and check it with `POST /v1/otp/verify`.
  </Card>

  <Card title="Transactional SMS" icon="message" href="/guides/transactional-sms">
    Receipts, alerts, and order updates on `POST /v1/sms/send`.
  </Card>

  <Card title="AI agents" icon="robot" href="/guides/ai-agents">
    Hosted MCP at `https://api.robase.dev/mcp` with an Agent API key.
  </Card>
</CardGroup>

## Coverage we can defend

Prepaid routes (source: `country_routes` seed and the [pricing table](https://robase.dev/pricing)):

| Market | Credits | NGN / message |
| - | - | - |
| Nigeria | 1–3 | ₦6–₦18 |
| Ghana | 3 | ₦18 |
| Kenya | 3 | ₦18 |
| South Africa | 4 | ₦24 |
| United Kingdom | 8 | ₦48 |
| Benin | 25–56 | ₦150–₦336 |
| Ivory Coast | 56–79 | ₦336–₦474 |
| United States | 50 | ₦300 |

Eight priced markets from the live rate table (`GET /v1/pricing`) and [robase.dev/pricing](https://robase.dev/pricing). Canada and other +1 numbers use the US route operationally and are not listed as priced markets (Canada is on the rate table at 10 credits). Additional destinations are added as priced routes — [ask](https://robase.dev/contact) if you need a country that is not on the table.

We do not publish a delivery-rate percentage. Credits are refunded when every upstream provider fails, or when anti-spam blocks a send before it reaches a carrier.

## Why Robase

<AccordionGroup>
  <Accordion title="One API for OTP and SMS">
    `POST /v1/otp/send` for one-time passcodes and `POST /v1/sms/send` for transactional messages. Same keys (`robe_` + 64 hex), same credits, same failover.
  </Accordion>

  <Accordion title="Failover where the seed has a fallback">
    Nigeria, Kenya, Ghana, South Africa, Benin, and Ivory Coast retry a fallback upstream if the primary rejects or times out. The United Kingdom and United States routes are currently single-provider.
  </Accordion>

  <Accordion title="Errors you can match on">
    Failures return `{ "error": { "type": "...", "message": "..." } }`. Match on `error.type` — it is stable. `error.message` is prose and may be translated.
  </Accordion>

  <Accordion title="Billing that fits prepaid wallets">
    Naira-first credits with Paystack and Flutterwave top-ups. Nigeria is 1 credit → ₦6/message. No monthly fee.
  </Accordion>
</AccordionGroup>

## Official SDKs

| Language | Package | Install |
| - | - | - |
| Node.js | [`@robasedev/sdk`](https://www.npmjs.com/package/@robasedev/sdk) | `npm install @robasedev/sdk` |
| Go | [`github.com/mantissatech/robase-sdk-go`](https://github.com/mantissatech/robase-sdk-go) | `go get github.com/mantissatech/robase-sdk-go` |
| PHP | [`robase/sdk`](https://packagist.org/packages/robase/sdk) | `composer require robase/sdk` |

There is no Python client. Any other language can call `https://api.robase.dev` directly.

## Get help

* Dashboard support tickets: [robase.dev/app/support](https://robase.dev/app/support)
* Email: [support@robase.dev](mailto:support@robase.dev)
* Status: [robase.dev/status](https://robase.dev/status)
* Public SDKs: [Node.js](https://github.com/mantissatech/robase-sdk-js), [Go](https://github.com/mantissatech/robase-sdk-go), [PHP](https://github.com/mantissatech/robase-sdk-php)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.