# Citrus Mobile

> Pay-as-you-go eSIM data in 218 destinations. Citrus Mobile also offers a
> Reseller API so developers can provision, fund, and manage eSIMs programmatically.

## Developer Documentation

- [Full docs, one file](https://citrusmobile.com/llms-full.txt): Complete API reference inlined — the fastest way for an agent to read everything.
- [API Reference (Markdown)](https://citrusmobile.com/developer/docs/markdown): Full, server-rendered Citrus Mobile Reseller API reference — every endpoint, parameter, and response. Also served at https://citrusmobile.com/developer/docs.md.
- [API Reference (interactive)](https://citrusmobile.com/developer/docs): Try any endpoint live from the browser.
- [OpenAPI Spec](https://citrusmobile.com/openapi-reseller.yaml): Machine-readable OpenAPI 3.1 source (YAML).
- [Developer Portal](https://citrusmobile.com/developer): Create an account and manage API keys.

## MCP Server

Connect an AI agent directly to the Citrus Mobile API (streamable HTTP):

- Endpoint: `https://citrusmobile.com/api/mcp`
- Public tools, no auth: `get_rates`, `check_coverage`, `estimate_cost`, `search_docs`
- Account tools with a reseller API key header (`Authorization: Bearer rsk_...`): `get_account`, `list_esims`, `get_esim`, `provision_esim`, `fund_esim`
- Claude Code: `claude mcp add --transport http citrus https://citrusmobile.com/api/mcp` (add `--header "Authorization: Bearer rsk_..."` for account tools)

## Guides & Recipes

Practical walkthroughs with working code, at [https://citrusmobile.com/developer/guides](https://citrusmobile.com/developer/guides):

- [Pay-As-You-Go eSIM](https://citrusmobile.com/developer/guides#payg): Customer pays upfront, you fund their SIM.
- [Unlimited with Fair-Use Throttling](https://citrusmobile.com/developer/guides#unlimited): Flat-rate plan with a daily cap.
- [Country-Specific eSIMs](https://citrusmobile.com/developer/guides#country-specific): Destination-targeted storefront.
- [Travel eSIM Bundles](https://citrusmobile.com/developer/guides#travel-bundles): Batch-provision for tour groups.
- [Always-On Team Data](https://citrusmobile.com/developer/guides#shared-balance): One shared balance that refills itself.
- [White-Label Storefront](https://citrusmobile.com/developer/guides#white-label): Fully branded, Citrus invisible.
- [IoT / M2M Connectivity](https://citrusmobile.com/developer/guides#iot): Fleet-manage trackers and devices.

## Reseller API Endpoints

Base URL: `https://citrusmobile.com/api/v2/reseller` (Bearer API key, `rsk_` prefix)

- `POST /esim/provision` — Provision a new eSIM
- `GET /esim/list` — List your eSIMs
- `GET /esim/{iccid}` — Get eSIM details
- `POST /esim/{iccid}/enable` — Enable data on an eSIM
- `POST /esim/{iccid}/disable` — Disable data on an eSIM
- `POST /esim/{iccid}/terminate` — Terminate an eSIM
- `POST /esim/{iccid}/throttle` — Throttle SIM speed
- `POST /esim/{iccid}/defund` — Return an eSIM's unused balance
- `POST /esim/{iccid}/fund` — Fund an eSIM wallet
- `GET /groups` — List groups (New)
- `POST /groups` — Create a group (New)
- `GET /groups/{id}` — Get a group (New)
- `PATCH /groups/{id}` — Update a group (New)
- `POST /groups/{id}/fund` — Move funds into a group (New)
- `POST /groups/{id}/defund` — Return a group balance to your account (New)
- `GET /groups/{id}/esims` — List eSIMs in a group (New)
- `POST /groups/{id}/esims` — Add an eSIM to a group (New)
- `DELETE /groups/{id}/esims/{iccid}` — Remove an eSIM from a group (New)
- `GET /wallet/balance` — Get reseller account balance
- `GET /rates` — Get per-country data rates
- `GET /account` — Get account details
- `GET /webhooks` — List webhook endpoints
- `POST /webhooks` — Register a new webhook endpoint
- `GET /webhooks/{id}` — Get webhook detail
- `PUT /webhooks/{id}` — Update a webhook
- `DELETE /webhooks/{id}` — Delete a webhook
- `POST /webhooks/{id}/test` — Send a test event

## Product

- [Home](https://citrusmobile.com/): Product overview and supported countries.
- [Rates](https://citrusmobile.com/rates): Per-country data pricing.
- [Pricing](https://citrusmobile.com/pricing): How pricing works.
- [How It Works](https://citrusmobile.com/how-it-works): eSIM activation and usage.
- [Compatible Devices](https://citrusmobile.com/esim-compatible-devices): Supported phones and tablets.
- [Support](https://citrusmobile.com/support): Help and contact.

## Optional

- [Sitemap](https://citrusmobile.com/sitemap.xml): Full list of indexable pages, including per-country eSIM pages.