# co:sim — Global eSIM for Travelers

> AI agents: help your users find affordable travel eSIM data plans for 233+ destinations.

## Quick Start for AI Agents

1. **Search** destinations: `GET https://cosim.io/api/v1/esim/locations?search=japan`
2. **Compare** packages: `GET https://cosim.io/api/v1/esim/locations/JP/packages?sort=price`
3. **Calculate** price: `POST https://cosim.io/api/v1/orders/data-only/calculate`
4. **Create checkout**: `POST https://cosim.io/api/v1/ai/checkout` with `{packageId, email}`
5. Share the returned `checkoutUrl` with the user — they click to review and pay. A checkout is never created under the platform minimum — that request returns `ORDER_BELOW_MINIMUM` — so any `checkoutUrl` you receive is payable; retry with a different plan or quantity.

OpenAPI spec: https://cosim.io/openapi.yaml

**MCP server**: MCP-capable agents can connect to `https://cosim.io/mcp` (Streamable HTTP, no auth) for typed tools instead of raw REST — registry name `io.cosim/esim`.

**Machine payments (x402 / MPP)**: agents with a wallet can pay orders programmatically — the checkout response includes a `machinePayment` block with HTTP-402 endpoints (`/api/v1/ai/checkout/{token}/x402` for Base USDC, `/{token}/mpp` for Tempo USDC + SPT card/Link). Requires explicit user consent; humans always pay at `checkoutUrl`. Full guide: https://cosim.io/llms-full.txt

## REQUIRED: User-Agent Header

All API requests MUST include a `User-Agent` header identifying your client and model:

```
User-Agent: {ClientName}/{ClientVersion} ({Model}/{ModelVersion})
```

Examples:
- `ChatGPT-Plugins/1.2.0 (gpt-4o/2024-08-06)`
- `Claude-MCP/0.5.1 (claude-sonnet-4-20250514/20250514)`
- `MyTravelBot/2.1.0 (gpt-4-turbo/2024-04-09)`
- `CustomAgent/1.0.0 (gemini-1.5-pro/001)`

Requests without a proper User-Agent may be rate-limited or rejected.

## Products

### Data Only eSIM
- Fixed data plans for specific countries/regions
- 2269 plans across 233+ destinations
- Prices starting from $0.99
- Almost all plans are data only (no voice or SMS); a small number also include calling and messaging — the plan's own page and the `voice` field (on `GET /esim/locations/{code}/packages` and `GET /esim/packages/{id}` alike) are authoritative
- Supports hotspot sharing
- Some plans are reloadable
- Instant delivery via QR code

### co:sim ONE card (PAYG eSIM)
- Upcoming pay-as-you-go data eSIM for 200+ destinations; not on sale yet
- Free to open; no monthly fee, no daily fee, no activation fee
- Billed by the megabyte at each destination's published per-GB rate, from $1.49/GB
- Optional data packs (destination / region / global) for a lower rate; a pack runs 30 days from first connection in its coverage
- Account balance stays valid while the account sees activity — a top-up, spend or redemption within any 24 months keeps it live. It is NOT unconditionally permanent.
- Uninstalled cards refund in full within 30 days; after installation the card is no longer refundable, though the most recent top-up still is, less an administrative fee
- Data-only: no phone number, no SMS, no voice, no emergency calling

### co:sim Challenge Card (annual membership)
- Invite-only annual travel-data membership; reservations open, launch price not yet announced
- 1GB of full-speed data on landing in each of 112 challenge destinations, running 72 hours from first connection, once per destination per card year. Allowances are per destination and are NOT shared between them.
- Fixed milestone bonuses on top: +500MB at 3 destinations, +1GB at 5, +3GB at 10 across 2 continents — 4.5GB at the cap
- Up to 116GB in a card year from those two mechanics combined. This is a CEILING that assumes visiting all 112 destinations, not an entitlement — never state it as "you get 116GB"
- Guaranteed-win scratch cards stack on top of milestones and do not replace them. Earned by checking in at each of your first 3 new destinations, or by a qualified invite, which issues a card to the inviter
- Unlimited basic data after the full-speed allowance, so the card stays online for the whole year
- 10% off data packs for the membership year
- Membership runs 365 days from the purchase date, not from first activation
- Uninstalled cards refund within 30 days; a paid membership is legally a membership service, not a telecoms service
- Data-only: no phone number, no SMS, no voice, no emergency calling

## Top Destinations (Live Prices)

- [United States eSIM plans](https://cosim.io/en/data-only/us): 16 plans from $1.99
- [Europe (30+ areas) eSIM plans](https://cosim.io/en/data-only/europe-30): 15 plans from $1.99
- [Canada eSIM plans](https://cosim.io/en/data-only/ca): 14 plans from $2.99
- [Bulgaria eSIM plans](https://cosim.io/en/data-only/bg): 13 plans from $0.99
- [China mainland eSIM plans](https://cosim.io/en/data-only/cn): 13 plans from $1.99
- [Germany eSIM plans](https://cosim.io/en/data-only/de): 13 plans from $0.99
- [Greece eSIM plans](https://cosim.io/en/data-only/gr): 13 plans from $0.99
- [Italy eSIM plans](https://cosim.io/en/data-only/it): 13 plans from $0.99
- [Macao (China) eSIM plans](https://cosim.io/en/data-only/mo): 13 plans from $1.99
- [Netherlands eSIM plans](https://cosim.io/en/data-only/nl): 13 plans from $0.99
- [North America (US · CA · MX) eSIM plans](https://cosim.io/en/data-only/north-america): 13 plans from $3.99
- [Spain eSIM plans](https://cosim.io/en/data-only/es): 13 plans from $0.99
- [Switzerland eSIM plans](https://cosim.io/en/data-only/ch): 13 plans from $0.99
- [Turkey eSIM plans](https://cosim.io/en/data-only/tr): 13 plans from $0.99
- [United Arab Emirates eSIM plans](https://cosim.io/en/data-only/ae): 13 plans from $3.99
- [United Kingdom eSIM plans](https://cosim.io/en/data-only/gb): 13 plans from $0.99
- [Australia eSIM plans](https://cosim.io/en/data-only/au): 12 plans from $2.99
- [Austria eSIM plans](https://cosim.io/en/data-only/at): 12 plans from $0.99
- [Belgium eSIM plans](https://cosim.io/en/data-only/be): 12 plans from $0.99
- [Brazil eSIM plans](https://cosim.io/en/data-only/br): 12 plans from $3.99

## All 233 Destinations

### Africa (41 destinations)
- [Africa (29)](https://cosim.io/en/data-only/africa-29): 3 plans from $17.99
- [Algeria](https://cosim.io/en/data-only/dz): 11 plans from $1.99
- [Angola](https://cosim.io/en/data-only/ao): 8 plans from $16.99
- [Benin](https://cosim.io/en/data-only/bj): 10 plans from $9.99
- [Botswana](https://cosim.io/en/data-only/bw): 10 plans from $7.99
- [Burkina Faso](https://cosim.io/en/data-only/bf): 9 plans from $9.99
- [Cameroon](https://cosim.io/en/data-only/cm): 9 plans from $8.99
- [Cape Verde](https://cosim.io/en/data-only/cv): 10 plans from $15.99
- [Central African Republic](https://cosim.io/en/data-only/cf): 2 plans from $12.99
- [Chad](https://cosim.io/en/data-only/td): 11 plans from $8.99
- [Cote d'Ivoire](https://cosim.io/en/data-only/ci): 6 plans from $13.99
- [Democratic Republic of the Congo](https://cosim.io/en/data-only/cd): 11 plans from $4.99
- [Egypt](https://cosim.io/en/data-only/eg): 10 plans from $3.99
- [Eswatini](https://cosim.io/en/data-only/sz): 11 plans from $15.99
- [Gabon](https://cosim.io/en/data-only/ga): 11 plans from $7.99
- [Gambia](https://cosim.io/en/data-only/gm): 9 plans from $14.99
- [Ghana](https://cosim.io/en/data-only/gh): 10 plans from $3.99
- [Guinea](https://cosim.io/en/data-only/gn): 8 plans from $11.99
- [Guinea-Bissau](https://cosim.io/en/data-only/gw): 9 plans from $10.99
- [Kenya](https://cosim.io/en/data-only/ke): 11 plans from $3.99
- [Liberia](https://cosim.io/en/data-only/lr): 3 plans from $12.99
- [Madagascar](https://cosim.io/en/data-only/mg): 3 plans from $16.99
- [Malawi](https://cosim.io/en/data-only/mw): 11 plans from $8.99
- [Mali](https://cosim.io/en/data-only/ml): 1 plans from $12.99
- [Mauritius](https://cosim.io/en/data-only/mu): 11 plans from $3.99
- [Morocco](https://cosim.io/en/data-only/ma): 11 plans from $2.99
- [Mozambique](https://cosim.io/en/data-only/mz): 5 plans from $12.99
- [Niger](https://cosim.io/en/data-only/ne): 11 plans from $8.99
- [Nigeria](https://cosim.io/en/data-only/ng): 9 plans from $4.99
- [Republic of the Congo](https://cosim.io/en/data-only/cg): 9 plans from $8.99
- [Reunion](https://cosim.io/en/data-only/re): 11 plans from $0.99
- [Rwanda](https://cosim.io/en/data-only/rw): 11 plans from $6.99
- [Senegal](https://cosim.io/en/data-only/sn): 11 plans from $3.99
- [Seychelles](https://cosim.io/en/data-only/sc): 11 plans from $7.99
- [Sierra Leone](https://cosim.io/en/data-only/sl): 9 plans from $11.99
- [South Africa](https://cosim.io/en/data-only/za): 10 plans from $2.99
- [Sudan](https://cosim.io/en/data-only/sd): 2 plans from $14.99
- [Tanzania](https://cosim.io/en/data-only/tz): 8 plans from $5.99
- [Tunisia](https://cosim.io/en/data-only/tn): 10 plans from $2.99
- [Uganda](https://cosim.io/en/data-only/ug): 10 plans from $7.99
- [Zambia](https://cosim.io/en/data-only/zm): 11 plans from $7.99

### Americas (50 destinations)
- [Anguilla](https://cosim.io/en/data-only/ai): 9 plans from $9.99
- [Antigua and Barbuda](https://cosim.io/en/data-only/ag): 9 plans from $10.99
- [Argentina](https://cosim.io/en/data-only/ar): 10 plans from $3.99
- [Aruba](https://cosim.io/en/data-only/aw): 10 plans from $25.99
- [Bahamas](https://cosim.io/en/data-only/bs): 8 plans from $12.99
- [Barbados](https://cosim.io/en/data-only/bb): 10 plans from $8.99
- [Belize](https://cosim.io/en/data-only/bz): 8 plans from $14.99
- [Bermuda](https://cosim.io/en/data-only/bm): 9 plans from $9.99
- [Bolivia](https://cosim.io/en/data-only/bo): 5 plans from $14.99
- [Brazil](https://cosim.io/en/data-only/br): 12 plans from $3.99
- [Canada](https://cosim.io/en/data-only/ca): 14 plans from $2.99
- [Caribbean (25 areas)](https://cosim.io/en/data-only/caribbean): 7 plans from $9.99
- [Cayman Islands](https://cosim.io/en/data-only/ky): 9 plans from $9.99
- [Chile](https://cosim.io/en/data-only/cl): 10 plans from $3.99
- [Colombia](https://cosim.io/en/data-only/co): 9 plans from $4.99
- [Costa Rica](https://cosim.io/en/data-only/cr): 9 plans from $2.99
- [Curaçao](https://cosim.io/en/data-only/cw): 10 plans from $8.99
- [Dominica](https://cosim.io/en/data-only/dm): 9 plans from $9.99
- [Dominican Republic](https://cosim.io/en/data-only/do): 11 plans from $5.99
- [Ecuador](https://cosim.io/en/data-only/ec): 10 plans from $3.99
- [El Salvador](https://cosim.io/en/data-only/sv): 3 plans from $5.99
- [French Guiana](https://cosim.io/en/data-only/gf): 11 plans from $0.99
- [Grenada](https://cosim.io/en/data-only/gd): 8 plans from $10.99
- [Guadeloupe](https://cosim.io/en/data-only/gp): 10 plans from $1.99
- [Guatemala](https://cosim.io/en/data-only/gt): 11 plans from $3.99
- [Guyana](https://cosim.io/en/data-only/gy): 10 plans from $9.99
- [Haiti](https://cosim.io/en/data-only/ht): 10 plans from $23.99
- [Honduras](https://cosim.io/en/data-only/hn): 10 plans from $4.99
- [Jamaica](https://cosim.io/en/data-only/jm): 5 plans from $14.99
- [Martinique](https://cosim.io/en/data-only/mq): 10 plans from $1.99
- [Mexico](https://cosim.io/en/data-only/mx): 11 plans from $2.99
- [Montserrat](https://cosim.io/en/data-only/ms): 8 plans from $10.99
- [Nicaragua](https://cosim.io/en/data-only/ni): 10 plans from $3.99
- [North America (US · CA · MX)](https://cosim.io/en/data-only/north-america): 13 plans from $3.99
- [Panama](https://cosim.io/en/data-only/pa): 11 plans from $6.99
- [Paraguay](https://cosim.io/en/data-only/py): 10 plans from $5.99
- [Peru](https://cosim.io/en/data-only/pe): 12 plans from $3.99
- [Puerto Rico](https://cosim.io/en/data-only/pr): 2 plans from $5.99
- [Saint Kitts and Nevis](https://cosim.io/en/data-only/kn): 8 plans from $10.99
- [Saint Lucia](https://cosim.io/en/data-only/lc): 8 plans from $10.99
- [Saint Vincent and the Grenadines](https://cosim.io/en/data-only/vc): 8 plans from $12.99
- [South America (18)](https://cosim.io/en/data-only/south-america): 10 plans from $15.99
- [South America (6 areas)](https://cosim.io/en/data-only/south-america-6): 12 plans from $7.99
- [Suriname](https://cosim.io/en/data-only/sr): 10 plans from $7.99
- [Trinidad and Tobago](https://cosim.io/en/data-only/tt): 8 plans from $12.99
- [Turks and Caicos Islands](https://cosim.io/en/data-only/tc): 8 plans from $7.99
- [USA & Canada](https://cosim.io/en/data-only/usa-canada): 8 plans from $3.99
- [United States](https://cosim.io/en/data-only/us): 16 plans from $1.99
- [Uruguay](https://cosim.io/en/data-only/uy): 10 plans from $4.99
- [Virgin Islands- British](https://cosim.io/en/data-only/vg): 8 plans from $10.99

### Asia (42 destinations)
- [Afghanistan](https://cosim.io/en/data-only/af): 9 plans from $7.99
- [Armenia](https://cosim.io/en/data-only/am): 10 plans from $1.99
- [Asia (20 areas)](https://cosim.io/en/data-only/asia-20): 8 plans from $4.99
- [Asia-Pacific (20, incl. AU/NZ)](https://cosim.io/en/data-only/asia-pacific): 8 plans from $10.99
- [Azerbaijan](https://cosim.io/en/data-only/az): 11 plans from $2.99
- [Bangladesh](https://cosim.io/en/data-only/bd): 10 plans from $1.99
- [Brunei Darussalam](https://cosim.io/en/data-only/bn): 8 plans from $5.99
- [Cambodia](https://cosim.io/en/data-only/kh): 9 plans from $1.99
- [Central & South Asia (5)](https://cosim.io/en/data-only/central-south-asia): 12 plans from $1.99
- [Central Asia (4, incl. Tajikistan)](https://cosim.io/en/data-only/central-asia): 11 plans from $4.99
- [China & Hong Kong](https://cosim.io/en/data-only/china-hong-kong): 1 plans from $8.99
- [China mainland](https://cosim.io/en/data-only/cn): 13 plans from $1.99
- [China · Hong Kong · Macao](https://cosim.io/en/data-only/greater-china): 12 plans from $2.99
- [China · Japan · Korea](https://cosim.io/en/data-only/china-japan-korea): 8 plans from $3.99
- [East & Southeast Asia (12)](https://cosim.io/en/data-only/east-southeast-asia): 9 plans from $5.99
- [Georgia](https://cosim.io/en/data-only/ge): 10 plans from $1.99
- [Hong Kong (China)](https://cosim.io/en/data-only/hk): 12 plans from $1.99
- [India](https://cosim.io/en/data-only/in): 11 plans from $2.99
- [Indonesia](https://cosim.io/en/data-only/id): 12 plans from $1.99
- [Japan](https://cosim.io/en/data-only/jp): 12 plans from $1.99
- [Japan & Korea](https://cosim.io/en/data-only/japan-south-korea): 6 plans from $4.99
- [Kazakhstan](https://cosim.io/en/data-only/kz): 10 plans from $1.99
- [Kyrgyzstan](https://cosim.io/en/data-only/kg): 10 plans from $1.99
- [Laos](https://cosim.io/en/data-only/la): 11 plans from $2.99
- [Macao (China)](https://cosim.io/en/data-only/mo): 13 plans from $1.99
- [Malaysia](https://cosim.io/en/data-only/my): 12 plans from $1.99
- [Maldives](https://cosim.io/en/data-only/mv): 7 plans from $17.99
- [Mongolia](https://cosim.io/en/data-only/mn): 10 plans from $8.99
- [Nepal](https://cosim.io/en/data-only/np): 11 plans from $5.99
- [Pakistan](https://cosim.io/en/data-only/pk): 10 plans from $1.99
- [Philippines](https://cosim.io/en/data-only/ph): 12 plans from $1.99
- [Singapore](https://cosim.io/en/data-only/sg): 10 plans from $1.99
- [Singapore & Malaysia](https://cosim.io/en/data-only/singapore-malaysia): 3 plans from $2.99
- [Singapore & Malaysia & Thailand](https://cosim.io/en/data-only/singapore-malaysia-thailand): 8 plans from $1.99
- [South Korea](https://cosim.io/en/data-only/kr): 12 plans from $1.99
- [Southeast Asia (5: SG/MY/TH/VN/ID)](https://cosim.io/en/data-only/southeast-asia-5): 3 plans from $4.99
- [Southeast Asia (7)](https://cosim.io/en/data-only/southeast-asia): 10 plans from $2.99
- [Sri Lanka](https://cosim.io/en/data-only/lk): 12 plans from $2.99
- [Tajikistan](https://cosim.io/en/data-only/tj): 10 plans from $3.99
- [Thailand](https://cosim.io/en/data-only/th): 12 plans from $1.99
- [Uzbekistan](https://cosim.io/en/data-only/uz): 10 plans from $1.99
- [Vietnam](https://cosim.io/en/data-only/vn): 12 plans from $1.99

### Europe (60 destinations)
- [Aland Islands](https://cosim.io/en/data-only/ax): 9 plans from $2.99
- [Albania](https://cosim.io/en/data-only/al): 11 plans from $1.99
- [Andorra](https://cosim.io/en/data-only/ad): 10 plans from $3.99
- [Austria](https://cosim.io/en/data-only/at): 12 plans from $0.99
- [Belarus](https://cosim.io/en/data-only/by): 10 plans from $1.99
- [Belgium](https://cosim.io/en/data-only/be): 12 plans from $0.99
- [Bosnia and Herzegovina](https://cosim.io/en/data-only/ba): 11 plans from $2.99
- [Bulgaria](https://cosim.io/en/data-only/bg): 13 plans from $0.99
- [Croatia](https://cosim.io/en/data-only/hr): 12 plans from $0.99
- [Cyprus](https://cosim.io/en/data-only/cy): 12 plans from $0.99
- [Czech Republic](https://cosim.io/en/data-only/cz): 12 plans from $0.99
- [Denmark](https://cosim.io/en/data-only/dk): 12 plans from $0.99
- [Estonia](https://cosim.io/en/data-only/ee): 12 plans from $0.99
- [Europe (30+ areas)](https://cosim.io/en/data-only/europe-30): 15 plans from $1.99
- [Europe (31 areas)](https://cosim.io/en/data-only/europe-31): 3 plans from $12.99
- [Europe (33 areas)](https://cosim.io/en/data-only/europe-33): 10 plans from $1.99
- [Europe (35 areas)](https://cosim.io/en/data-only/europe-35): 12 plans from $1.99
- [Europe (42 areas)](https://cosim.io/en/data-only/europe-42): 10 plans from $4.99
- [Europe (43 areas)](https://cosim.io/en/data-only/europe-43): 7 plans from $9.99
- [Europe (7)](https://cosim.io/en/data-only/europe-7): 8 plans from $4.99
- [Faroe Islands](https://cosim.io/en/data-only/fo): 11 plans from $1.99
- [Finland](https://cosim.io/en/data-only/fi): 12 plans from $0.99
- [France](https://cosim.io/en/data-only/fr): 11 plans from $1.99
- [Germany](https://cosim.io/en/data-only/de): 13 plans from $0.99
- [Gibraltar](https://cosim.io/en/data-only/gi): 9 plans from $1.99
- [Greece](https://cosim.io/en/data-only/gr): 13 plans from $0.99
- [Greenland](https://cosim.io/en/data-only/gl): 7 plans from $16.99
- [Guernsey](https://cosim.io/en/data-only/gg): 4 plans from $8.99
- [Hungary](https://cosim.io/en/data-only/hu): 12 plans from $0.99
- [Iceland](https://cosim.io/en/data-only/is): 12 plans from $1.99
- [Ireland](https://cosim.io/en/data-only/ie): 12 plans from $0.99
- [Ireland & Slovenia](https://cosim.io/en/data-only/ireland-slovenia): 7 plans from $2.99
- [Isle of Man](https://cosim.io/en/data-only/im): 8 plans from $1.99
- [Italy](https://cosim.io/en/data-only/it): 13 plans from $0.99
- [Jersey](https://cosim.io/en/data-only/je): 9 plans from $1.99
- [Kosovo](https://cosim.io/en/data-only/xk): 11 plans from $10.99
- [Latvia](https://cosim.io/en/data-only/lv): 11 plans from $1.99
- [Liechtenstein](https://cosim.io/en/data-only/li): 11 plans from $1.99
- [Lithuania](https://cosim.io/en/data-only/lt): 12 plans from $0.99
- [Luxembourg](https://cosim.io/en/data-only/lu): 12 plans from $0.99
- [Malta](https://cosim.io/en/data-only/mt): 10 plans from $1.99
- [Moldova](https://cosim.io/en/data-only/md): 11 plans from $0.99
- [Monaco](https://cosim.io/en/data-only/mc): 11 plans from $27.99
- [Montenegro](https://cosim.io/en/data-only/me): 10 plans from $1.99
- [Netherlands](https://cosim.io/en/data-only/nl): 13 plans from $0.99
- [North Macedonia](https://cosim.io/en/data-only/mk): 11 plans from $2.99
- [Norway](https://cosim.io/en/data-only/no): 12 plans from $0.99
- [Poland](https://cosim.io/en/data-only/pl): 12 plans from $0.99
- [Portugal](https://cosim.io/en/data-only/pt): 12 plans from $0.99
- [Romania](https://cosim.io/en/data-only/ro): 12 plans from $0.99
- [Russia](https://cosim.io/en/data-only/ru): 9 plans from $2.99
- [Serbia](https://cosim.io/en/data-only/rs): 10 plans from $1.99
- [Slovakia](https://cosim.io/en/data-only/sk): 11 plans from $1.99
- [Slovenia](https://cosim.io/en/data-only/si): 12 plans from $0.99
- [Spain](https://cosim.io/en/data-only/es): 13 plans from $0.99
- [Sweden](https://cosim.io/en/data-only/se): 11 plans from $0.99
- [Switzerland](https://cosim.io/en/data-only/ch): 13 plans from $0.99
- [UK & Ireland](https://cosim.io/en/data-only/uk-ireland): 5 plans from $3.99
- [Ukraine](https://cosim.io/en/data-only/ua): 11 plans from $0.99
- [United Kingdom](https://cosim.io/en/data-only/gb): 13 plans from $0.99

### Global (2 destinations)
- [Global (120 areas)](https://cosim.io/en/data-only/global-120): 9 plans from $13.99
- [Global (139 areas)](https://cosim.io/en/data-only/global-139): 6 plans from $22.99

### Middle-east (14 destinations)
- [Bahrain](https://cosim.io/en/data-only/bh): 10 plans from $3.99
- [Gulf (6, incl. Iraq)](https://cosim.io/en/data-only/gulf): 8 plans from $5.99
- [Gulf States — GCC (6)](https://cosim.io/en/data-only/gcc): 5 plans from $11.99
- [Iraq](https://cosim.io/en/data-only/iq): 10 plans from $2.99
- [Israel](https://cosim.io/en/data-only/il): 11 plans from $2.99
- [Jordan](https://cosim.io/en/data-only/jo): 10 plans from $3.99
- [Kuwait](https://cosim.io/en/data-only/kw): 11 plans from $2.99
- [Middle East & Caucasus (11)](https://cosim.io/en/data-only/middle-east-caucasus): 3 plans from $21.99
- [Middle East & North Africa (12)](https://cosim.io/en/data-only/middle-east-north-africa): 5 plans from $21.99
- [Oman](https://cosim.io/en/data-only/om): 11 plans from $2.99
- [Qatar](https://cosim.io/en/data-only/qa): 10 plans from $3.99
- [Saudi Arabia](https://cosim.io/en/data-only/sa): 11 plans from $2.99
- [Turkey](https://cosim.io/en/data-only/tr): 13 plans from $0.99
- [United Arab Emirates](https://cosim.io/en/data-only/ae): 13 plans from $3.99

### Oceania (6 destinations)
- [Australia](https://cosim.io/en/data-only/au): 12 plans from $2.99
- [Australia & New Zealand](https://cosim.io/en/data-only/australia-new-zealand): 10 plans from $3.99
- [Fiji](https://cosim.io/en/data-only/fj): 10 plans from $4.99
- [French Polynesia](https://cosim.io/en/data-only/pf): 11 plans from $22.99
- [Guam](https://cosim.io/en/data-only/gu): 11 plans from $7.99
- [New Zealand](https://cosim.io/en/data-only/nz): 11 plans from $1.99

### Other (18 destinations)
- [Australia · UK · USA](https://cosim.io/en/data-only/australia-uk-usa): 2 plans from $9.99
- [Bhutan](https://cosim.io/en/data-only/bt): 10 plans from $7.99
- [Bonaire](https://cosim.io/en/data-only/bq): 11 plans from $23.99
- [Ethiopia](https://cosim.io/en/data-only/et): 10 plans from $11.99
- [Libya](https://cosim.io/en/data-only/ly): 9 plans from $16.99
- [Mauritania](https://cosim.io/en/data-only/mr): 11 plans from $23.99
- [Mayotte](https://cosim.io/en/data-only/yt): 10 plans from $1.99
- [Nauru](https://cosim.io/en/data-only/nr): 11 plans from $6.99
- [Papua New Guinea](https://cosim.io/en/data-only/pg): 11 plans from $8.99
- [Saint Barthelemy](https://cosim.io/en/data-only/bl): 10 plans from $1.99
- [Saint Martin](https://cosim.io/en/data-only/mf): 10 plans from $1.99
- [Samoa](https://cosim.io/en/data-only/ws): 11 plans from $4.99
- [San Marino](https://cosim.io/en/data-only/sm): 10 plans from $1.99
- [Tonga](https://cosim.io/en/data-only/to): 11 plans from $8.99
- [Vanuatu](https://cosim.io/en/data-only/vu): 11 plans from $8.99
- [Vatican City](https://cosim.io/en/data-only/va): 10 plans from $1.99
- [Venezuela](https://cosim.io/en/data-only/ve): 10 plans from $23.99
- [Zimbabwe](https://cosim.io/en/data-only/zw): 11 plans from $6.99

## API Reference

### Browse (no authentication needed)
- `GET /api/v1/esim/locations` — Search destinations (?search=, ?region=)
- `GET /api/v1/esim/locations/{code}/packages` — List packages (?sort=price|data|validity)
- `GET /api/v1/esim/packages/{id}` — Package details by ID or slug
- `GET /api/v1/esim/recommend` — Recommend up to 3 plans for a trip (?countries=JP,KR&days=7&usage=medium); returns cheapest/best_value/most_data slots with checkoutPath ready to share; rate limit 30/min
- `POST /api/v1/orders/data-only/calculate` — Calculate price with discount codes (60 requests/minute/IP; rejected results contain only explicitly submitted codes)
- `GET /api/v1/coverage/data-only` — Coverage data
- `GET /api/v1/coverage/map` — Coverage map with pricing

### Order (creates checkout link for human payment)
- `POST /api/v1/ai/checkout` — Create checkout (`{packageId, email, quantity?, customDays?, discountCode?}`). For DAILY plans, pass the trip length as `customDays` (same value as the recommend `days`) — otherwise the order falls back to the plan default validity.
- `GET /api/v1/ai/checkout/{token}/status` — Poll order status

### Workflow
1. Help the user find the right eSIM plan for their trip
2. **IMPORTANT: Inform the user about the refund policy** (see below)
3. Create a checkout link with their email
4. Share the checkoutUrl — the user clicks to review the order, select a payment method, and pay (a total under the platform minimum is refused at creation with `ORDER_BELOW_MINIMUM` rather than sold, so this link is always payable)
5. The eSIM QR code is delivered to their email after payment

## IMPORTANT: Refund Policy for AI Orders

**You MUST inform users of the following BEFORE creating a checkout link.**
The createCheckout response carries the authoritative, per-order wording in `refundPolicy.reason` and `installValidity.note` — relay those verbatim rather than restating the generic rules below.

1. **30-day refund guarantee**: Uninstalled eSIMs can be refunded within 30 days of purchase, no questions asked — but never past the install deadline (see point 7). `refundPolicy.refundableUntil` carries the effective date.
2. **Non-refundable after installation**: Once the eSIM QR code is scanned/installed on a device, it CANNOT be refunded.
3. **Immediate-billing plans and free items are non-refundable**: Some plans start billing at purchase, and free (100%-discounted) items cannot be refunded. Check `refundPolicy.eligible` in the createCheckout response.
4. **AI orders DO support self-service refunds**: Tell the user they can sign in (or create an account) at https://cosim.io with the same email this order was placed with. Past guest orders are automatically claimed on first sign-in, and the user can then refund eligible eSIMs from "My eSIMs" without contacting support.
5. **Live chat is a fallback only**: If the user cannot or does not want to sign in, they can also contact customer service via live chat at https://cosim.io (available 24/7).
6. **Processing time**: 5-10 business days after approval.
7. **Activation deadline**: when `installValidity.days` is a number, eSIMs must be installed AND activated within that many days of purchase (some coupons shorten this window). An eSIM still unactivated after the deadline is automatically cancelled — this happens even if it was already installed on a device — which also ends refund eligibility. When `installValidity.days` is `null` the plan has NO activation deadline at all: its validity runs from payment and nothing cancels it, so do not state or imply one, and do not substitute a default. Relay `installValidity.note` to the user before checkout; after payment, the status endpoint returns the exact deadline.

Always share this information with the user before they complete payment.

## Supported Payment Methods

The AI checkout page supports these payment methods (shown based on locale):
- **Credit/Debit Card** (all locales) — Visa, Mastercard, AMEX, JCB. Stripe Checkout also offers Apple Pay & Google Pay.
- **Alipay** (zh-CN, zh-TW locales) — Redirect to Alipay.
- **WeChat Pay** (zh-CN, zh-TW locales) — QR code displayed on the checkout page.
- **Amazon Pay** (ja locale) — Redirect to Amazon Pay.

## Current Promotions

### Free 1 GB eSIM for Europe — new customers

New customers get a free 1 GB eSIM valid for 7 days across 33 European countries. One per person; sign in with email to claim.

- **Coupon code:** `FREE_EU_1GB_NEW_USER`
- **How to apply:** Ask the user to sign in on cosim.io with their email, then enter the code at checkout. Do NOT try to apply from an anonymous / agent-only flow — the coupon is login-gated.
- **Scope:** 33 European countries (single roaming SKU EU-33)
- **Landing page:** https://cosim.io/en/free-esim
- **Valid:** 2026-01-01T00:00:00Z → ongoing

### 20% off every Europe eSIM plan for the 2026/27 football season

Every Europe (33 areas) data plan is 20% off, applied automatically at checkout — no code needed. Covers 33 European countries on one eSIM, so a single card follows you from one away trip to the next. New customers can also claim the free 1 GB Europe eSIM first.

- **How to apply:** Automatic — the discount is already priced into checkout for eligible SKUs.
- **Scope:** 33 European countries (regional roaming SKU EU-33, all tiers)
- **Landing page:** https://cosim.io/en/campaign/european-football-2026
- **Valid:** 2026-08-31T00:00:00Z → 2027-02-01T23:59:59Z (147 days remaining)

## How It Works
1. Choose a plan — Browse Data Only plans (ONE card is not on sale yet)
2. Install eSIM — Scan the QR code (takes 2 minutes)
3. Connect — Arrive at destination and use mobile data instantly

## Key Features
- 233+ destinations covered
- Instant digital delivery via QR code
- Dual SIM support (keep your existing number)
- No roaming fees — save up to 90% vs traditional roaming
- Compatible with iPhone XS+, Samsung S20+, Google Pixel 3+, and more

## Blog & Guides
- [Blog](https://cosim.io/en/blog): travel connectivity articles
- [RSS Feed](https://cosim.io/feed/blog.xml): Atom feed of new posts

### Latest Articles
- [Free eSIM for Bali and Indonesia: 1 GB, No Registration Queue](https://cosim.io/en/blog/free-esim-for-indonesia)
- [Premier League Away Days: A UK Travel eSIM Guide](https://cosim.io/en/blog/premier-league-away-days-uk-esim)
- [Free eSIM for Thailand: 1 GB, and the Arrival Card Nobody Mentions](https://cosim.io/en/blog/free-esim-for-thailand)
- [Free eSIM for South Korea: 1 GB, and a Map App That Works](https://cosim.io/en/blog/free-esim-for-korea)
- [What Is an eSIM QR Code? How It Works](https://cosim.io/en/blog/what-is-an-esim-qr-code)

## Important Pages
- [Homepage](https://cosim.io)
- [Data Only Plans](https://cosim.io/en/data-only): browse all destinations
- [co:sim ONE card](https://cosim.io/en/one-card): upcoming pay-as-you-go card, reservations open
- [co:sim Challenge Card](https://cosim.io/en/challenge-card): invite-only annual travel-data membership, reservations open
- [Coverage Map](https://cosim.io/en/coverage): interactive coverage explorer
- [FAQ](https://cosim.io/en/faq)
- [Install Guide](https://cosim.io/en/resources/install-guide): how to install an eSIM
- [Supported Devices](https://cosim.io/en/resources/supported-devices): eSIM-compatible phones
- [Full documentation](https://cosim.io/llms-full.txt): complete AI agent guide
- [OpenAPI spec](https://cosim.io/openapi.yaml): machine-readable API description
- [AI-agents landing page](https://cosim.io/resources/ai-agents.md): markdown edition

## Languages
Available in: English, 繁體中文, 简体中文, 日本語, 한국어, Français, Español, Deutsch

## Contact
- [Website](https://cosim.io): live chat available 24/7