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

# API reference

> REST API for email and SMS. Every endpoint with a live playground.

The Robase API is a RESTful HTTP API. All requests return JSON, all requests are authenticated with a bearer token, and every mutating endpoint supports idempotency.

## Base URL

```
https://api.robase.dev/v1
```

## Authentication

```http theme={null}
Authorization: Bearer rb_live_xxxxxxxxxxxx
```

See [Authentication](/api-reference/authentication) for key formats, scopes, and test vs. live mode.

## Conventions

<CardGroup cols={2}>
  <Card title="IDs" icon="fingerprint">
    UUIDv7 — time-ordered, greppable, 128-bit.
  </Card>

  <Card title="Timestamps" icon="clock">
    ISO 8601 in UTC. `2026-04-17T10:30:00Z`.
  </Card>

  <Card title="Money" icon="coins">
    Smallest currency unit (`amount_kobo` for NGN, `amount` + `currency` for multi-currency responses).
  </Card>

  <Card title="Pagination" icon="arrow-right">
    Cursor-based. `?cursor=...&limit=50`. `next_cursor` in the response when there's more.
  </Card>
</CardGroup>

## Rate limits

10 requests per second per project by default. See [Rate limits](/concepts/rate-limits) for how to back off and request higher ceilings.

## Errors

Every error follows a single shape. Switch on `error.type` — it's stable across versions. See [Errors](/api-reference/errors).

## Next

<CardGroup cols={2}>
  <Card title="Send your first SMS" icon="paper-plane" href="/api-reference/sms/send">
    `POST /v1/sms`
  </Card>

  <Card title="Send an email" icon="envelope" href="/api-reference/emails/send">
    `POST /v1/emails`
  </Card>
</CardGroup>