# GMJ Roaming API

> eSIM reseller API: browse packages, buy eSIMs from account balance, top up data, manage eSIMs. v1 is production; v2 is alpha.

## Documentation

- [Webhooks](/webhooks.md): Get eSIM events pushed to your server instead of polling.
- [Versions](/versions.md): v1 is production. v2 is alpha.
- [Quickstart](/quickstart.md): Buy your first eSIM with the v1 API in four requests.
- [Managing eSIMs](/managing-esims.md): Install links, usage, suspend, cancel and revoke.
- [Introduction](/introduction.md): What the GMJ Roaming API does and how an integration fits together.
- [Errors](/errors.md): Response envelope and HTTP status codes.
- [Buying eSIMs](/buying-esims.md): Checkout, retries and top-ups.
- [Authentication](/authentication.md): Authenticate with the X-API-KEY header.
- [AI & MCP](/ai-tools.md): Use these docs from Claude, ChatGPT, Cursor and other AI tools.

## API reference

- [OpenAPI v1](/openapi/v1.yaml): https://api.gmjroaming.com/api/v1 (production)
- [OpenAPI v2](/openapi/v2.yaml): https://api.gmjroaming.com/api/v2 (ALPHA, may change at any time, not for production)
- [MCP server](/ai-tools.md): https://docs.gmjroaming.com/mcp (read-only docs search)