What you get
- Your plans on our comparison pages for 84 countries, ranked only by price for the same data and days, with a link to the page where each plan is sold.
- Your brand in the open price data others cite (CSV and JSON per country, CC BY 4.0).
- Correct prices: your file is read every day, so a price change shows within 24 hours.
Inbox eSIM sells eSIMs too. That is exactly why the rules are public: same ranking for everyone, every price dated, and where another brand is cheaper than us, the page says so. How we compare.
The rules
- The prices in the file are the ones on your site, for anyone, today. No member-only or code prices.
- Once a week we compare three random plans with your own pages. If they do not match, the file stops showing until they do, and we tell you.
- The file sits at a stable https:// address, under 6 MB, readable without a login.
- You can leave at any time: write to partners@inboxesim.com and your plans come off within 48 hours.
The file
| Field | Required | What it holds |
|---|---|---|
country | yes | ISO 3166 two-letter code (JP, US, GB). One country per plan. |
data_gb | yes | GB in the plan, or null for unlimited or daily-allowance plans. |
days | yes | Validity in whole days. |
price | yes | The price a shopper pays on your site today, before any code. |
currency | yes | ISO 4217 code: USD, EUR, GBP and so on. We convert to US dollars on the day. |
url | yes | The page on your site where this plan is sold. |
daily_gb | for unlimited | Full-speed GB a day, when the plan has a daily allowance. |
speed_after | for unlimited | The speed after the allowance, as you state it ("1 Mbps"). |
network, hotspot, topup, app_required | no | Shown with the plan when given. |
At the top level: brand, website (https) and plans; updated is optional. An example (also as a file: example.json):
{
"brand": "Example eSIM",
"website": "https://example.com",
"updated": "2026-10-28",
"plans": [
{ "country": "JP", "data_gb": 5, "days": 30, "price": 6.99, "currency": "USD",
"url": "https://example.com/japan", "network": "NTT Docomo", "hotspot": true },
{ "country": "JP", "data_gb": null, "daily_gb": 2, "speed_after": "1 Mbps", "days": 7,
"price": 19.5, "currency": "USD", "url": "https://example.com/japan" }
]
}Check your file
The checker reads your file now and names every problem with its plan number. Nothing is published until a person has looked at your site and your file.
Already listed? Point your readers to it
If you want shoppers to see your prices next to the market, link to the comparison of a country you sell, for example <a href="https://inboxesim.com/compare/japan">Japan eSIM prices compared</a>. Optional, and it changes nothing in the ranking: plans are ordered by price for the same data and days, whoever links here.
Or show the badge, linked to your own brand page (we send you its address when you are listed):
<a href="https://inboxesim.com/compare/brands/your-id"><img src="https://inboxesim.com/badges/listed-on-inbox-esim.svg" width="220" height="48" alt="Prices compared on Inbox eSIM"></a>
Your own plans file in the format many comparison sites already read (a products list with plan name, validity, data, prices, coverages and link) works too; you do not need a second file.
Questions
An API instead of a file, or a different format? Write to partners@inboxesim.com and we will read it with you.