# Changelog

> Dated changelog of the Roamify API documentation: new modules, endpoints and webhook events, from the first eSIM docs to refunds, vouchers, insurance and the AI-readable docs.

Canonical: https://docs.getroamify.com/changelog/

What changed in the Roamify API documentation, newest first. Dates are when the change was published to the docs. Each entry links to the page it affects.

## November 2026
- **AI-readable docs.** Every page is available as markdown by adding `.md` to its URL (for example `/esims/orders.md`) or by sending `Accept: text/markdown`. Pages have a "Copy page" menu. The docs publish [`/llms.txt`](https://docs.getroamify.com/llms.txt), [`/llms-full.txt`](https://docs.getroamify.com/llms-full.txt) and an [OpenAPI description](https://docs.getroamify.com/openapi.json). Added the [FAQ](https://docs.getroamify.com/faq/), [API Errors](https://docs.getroamify.com/errors/) and two [guides](https://docs.getroamify.com/guides/sell-esims-in-your-app/).
- **2026-11-08: Refunds.** New [Refunds](https://docs.getroamify.com/esims/refunds/) page for creating, bulk-creating, getting, listing and cancelling refund requests, and a new [Refund webhook event](https://docs.getroamify.com/webhooks/types/refund/) (`refunded` and `rejected`).

## September 2026
- **2026-09-01: Vouchers.** New [Vouchers](https://docs.getroamify.com/esims/vouchers/) page: mint batches of redeemable voucher codes, list, get, get by code and revoke. Available to selected partners, enabled per API key.

## July 2026
- **2026-07-10: Insurance module.** New [Insurance](https://docs.getroamify.com/insurance/overview/) module with [countries](https://docs.getroamify.com/insurance/countries/), [packages](https://docs.getroamify.com/insurance/packages/), [orders](https://docs.getroamify.com/insurance/orders/) and [policies](https://docs.getroamify.com/insurance/policies/).

## June 2026
- **2026-06-09: Package pagination and top-up flow.** [eSIM packages](https://docs.getroamify.com/esims/packages/) are paginated with `page` and `pageSize`, and the country parameters are clarified. New [Top-up flow](https://docs.getroamify.com/esims/topup-flow/) page, and [Send SMS](https://docs.getroamify.com/esims/esims/#send-sms) to an eSIM was added to the eSIM management docs. Webhook and authentication pages were reworked.
- **2026-06-09: Gift card API removed.** The gift card API documentation and its references were removed.

## January 2026
- **2026-01-07: eSIMs Link.** New [eSIMs Link](https://docs.getroamify.com/esims/esims-link/) page for generating shareable installation links.
- **2026-01-09:** Added the Android quick install URL.

## December 2025
- **2025-12-03: Exchange rates.** New [Exchange Rates](https://docs.getroamify.com/exchange-rates/overview/) module with [supported currencies](https://docs.getroamify.com/exchange-rates/get-currencies/) and [exchange rates](https://docs.getroamify.com/exchange-rates/get-exchange-rates/).

## August 2025
- **2025-08-29: eSIM events.** New [eSIM Events](https://docs.getroamify.com/esims/events/) page for the lifecycle event history of an eSIM.

## July 2025
- **2025-07-08: Webhooks.** New [Webhooks](https://docs.getroamify.com/webhooks/overview/) module with [eSIM status](https://docs.getroamify.com/webhooks/types/esim-status/), [eSIM usage](https://docs.getroamify.com/webhooks/types/esim-usage/), [partner balance](https://docs.getroamify.com/webhooks/types/partner-balance/) and [affiliate order](https://docs.getroamify.com/webhooks/types/affiliate-orders/) events.
- **2025-07-30: Webhook verification.** New [Webhook verification](https://docs.getroamify.com/webhooks/verification/) page for the `X-Roamify-Signature` header.

## June 2025
- **2025-06-18: Affiliate module.** New [Affiliate](https://docs.getroamify.com/affiliate/overview/) module with [affiliate links](https://docs.getroamify.com/affiliate/affiliate-links/).

## November 2024
- **2024-11-01: First version.** First published version of the Roamify API documentation.