Roamify eSIM API Breaking Changes
Discover Roamify’s latest eSIM API updates, including new paginated responses for GET /api/esim/packages, stricter country and countryCode validation via GET…
We're rolling out a set of API updates that bring new endpoints, expanded functionality, and a few changes you'll want to be aware of before updating your integration.
⚠️ Breaking Changes — Get eSIM Packages #
Endpoint: GET /api/esim/packages
https://roamify.apidog.io/get-esim-packages-12947634e0
1. Response is now paginated #
This endpoint now returns paginated results instead of all packages in a single response. If your integration fetches packages without pagination parameters, you may only be receiving the first page of results.
Action required: Update your integration to handle paginated responses using the page and pageSize query parameters.
| Parameter | Type | Default | Description |
|---|---|---|---|
| page | string | 1 | Page number to retrieve. |
| pageSize | string | 50 | Number of results per page. |
To retrieve all packages, iterate through pages until the response returns fewer results than your pageSize.
2. country and countryCode now have distinct meanings #
Previously these fields may have been used interchangeably. They now serve different purposes and both must use values sourced from the GET /api/esim/countries endpoint — arbitrary strings are no longer accepted.
| Parameter | Accepted value | Source |
|---|---|---|
| country | Full country name | name field from the Country API |
| countryCode | ISO country code | code field from the Country API |
Action required: If you are currently passing free-text country strings, update your integration to first call GET /api/esim/countries and use the name or code values from the response.
New Endpoints #
GET /api/esim/countries #
https://roamify.apidog.io/get-esim-supported-country-12947635e0
Returns a list of all countries supported by Roamify eSIM. Use the name and code values from this response as filter inputs when querying GET /api/esim/packages.
optional filter parameter available with geography
POST /api/esim/sms #
https://roamify.apidog.io/send-sms-37579804e0
Send an SMS message directly to an eSIM.
| Name | Type | Required | Description |
|---|---|---|---|
| iccid | string | required | The ICCID of the eSIM to send the SMS to. |
| message | string | required | The message content to send. |
Updated Endpoints #
POST /api/esim/apply — startDate now supported #
A new optional startDate field has been added to the Generate eSIM Profile endpoint. For a small subset of packages (~30 out of 28,000+), this field is required.
You can identify these packages by checking if requirements.travelDate is true in the package object. If required and not provided, the profile generation request will fail.
| Name | Type | Required | Description |
|---|---|---|---|
| startDate | string | conditional | Travel start date in ISO 8601 format. Required if requirements.travelDate is true. |
Timeout reminder
Full API Reference #
Full documentation is available at docs.getroamify.com.
If you have any questions or need help updating your integration, reach out to our partner support team.
Frequently asked questions
You will learn how eSIM activation works, how to compare data plans, and which setup steps matter most before and during your trip.
Match your plan to trip length, expected daily data use, hotspot needs, and network quality in your destination. Short stays usually need less data, while remote work and video calls need more.
Use the destination links in this guide to go directly to Roamify country pages, compare plan options, and complete checkout before departure.
Popular eSIM plans
Hand-picked destinations for your next trip.
Buy Turkey eSIM plans
Buy Thailand eSIM plans
Buy United Arab emirates eSIM plans
Buy Singapore eSIM plans
Buy Australia eSIM plans
Buy Mexico eSIM plansHeading somewhere new? Stay connected the moment you land.
Affordable travel data for 200+ destinations. No roaming charges, no hidden fees, just scan and go.
Keep reading
All articles
eSIM for Peru: The Complete Connectivity Guide for 2026
Planning a trip to Peru in 2026? Stay connected across Lima, Cusco, Machu Picchu, the Sacred Valley, and the Amazon with a hassle-free eSIM. Learn how to check device compatibility, choose the right data plan, understand coverage by region, and decide between an eSIM and local SIM. Discover why Roamify’s affordable, data-only eSIMs (from $2) are ideal for travelers who want instant activation on arrival, no roaming fees, and reliable mobile data throughout Peru.
Marissa Ling 
eSIM for Saudi Arabia: How to Stay Connected as a Visitor in 2026
Planning a trip to Saudi Arabia in 2026? Skip expensive roaming and airport SIM queues by using a travel eSIM. This guide explains eSIM compatibility, coverage on STC, Mobily, and Zain, 4G/5G availability in Riyadh, Jeddah, Mecca, Medina, and AlUla, how much data you really need, and step-by-step eSIM setup before you fly. Compare leading providers like Roamify, Airalo, and Holafly, learn about VPN and app usage (WhatsApp, Telegram, social media), and get practical tips to stay connected smoothly during Hajj, Umrah, business, or leisure travel in Saudi Arabia.
Michael Harbour
Roamify Partner Program: How to Earn Money Reselling eSIMs in 2026
Discover the Roamify Partner Program, a high-converting travel eSIM affiliate and reseller opportunity built for bloggers, comparison sites, travel agencies, and digital nomad communities. Promote data-only eSIMs from just $2 with coverage in 200+ countries, a 4.6 Trustpilot rating, top-ranked customer support, and a 5% discount code (ROAM5) to boost conversions. Apply in minutes at partner.getroamify.com and start earning commissions by recommending one of the cheapest, most reliable travel eSIM providers on the market.
Donald Bogle