# Roamly API

> Programmatic access to Roamly's travel eSIM plan catalog.

- [Introduction](https://docs.onroamly.com/introduction.md): Programmatic access to Roamly's travel eSIM plan catalog.
- [Authentication](https://docs.onroamly.com/authentication.md): API keys, rate limits, and error handling.
- [List destinations](https://docs.onroamly.com/api-reference/destinations/list-destinations.md): Every country and regional bundle with at least one plan on sale, including a plan count and the cheapest plan's price. Use each destination's `slug` to filter `/v1/plans`.
- [List plans](https://docs.onroamly.com/api-reference/plans/list-plans.md): The complete sellable catalog. Filter to one destination with `?destination={slug}` (slugs come from `/v1/destinations`).
- [Get a plan](https://docs.onroamly.com/api-reference/plans/get-a-plan.md): A single plan by its `id`.
- [List your eSIMs](https://docs.onroamly.com/api-reference/esims/list-your-esims.md): Every eSIM purchased by the account this API key belongs to, newest first, with installation details and the latest usage reading.
- [Get an eSIM](https://docs.onroamly.com/api-reference/esims/get-an-esim.md): A single eSIM belonging to your account.

## OpenAPI Specs

- [openapi](/openapi.yaml)