# co:sim — Global eSIM for Travelers > AI agents: help your users find affordable travel eSIM data plans for 224+ 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. 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`. ## 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 - 2167 plans across 224+ destinations - Prices starting from $0.99 - No voice or SMS — data only - Supports hotspot sharing - Some plans are reloadable - Instant delivery via QR code ### Global Prepaid eSIM - Upcoming prepaid data service for 200+ destinations - Pay-as-you-go data billing or optional data packages - Balance never expires - No monthly fee or maintenance charge - Does not include a phone number, SMS, or traditional voice calls ## Top Destinations (Live Prices) | Destination | Plans | From (USD) | Browse | |-------------|-------|------------|--------| | United States | 17 | $0.99 | https://cosim.io/en/data-only/us | | Canada | 15 | $0.99 | https://cosim.io/en/data-only/ca | | Europe (30+ areas) | 15 | $1.99 | https://cosim.io/en/data-only/europe-30 | | Australia | 13 | $1.99 | https://cosim.io/en/data-only/au | | Bulgaria | 13 | $0.99 | https://cosim.io/en/data-only/bg | | China mainland | 13 | $1.99 | https://cosim.io/en/data-only/cn | | Germany | 13 | $0.99 | https://cosim.io/en/data-only/de | | Greece | 13 | $0.99 | https://cosim.io/en/data-only/gr | | Italy | 13 | $0.99 | https://cosim.io/en/data-only/it | | Macao (China) | 13 | $1.99 | https://cosim.io/en/data-only/mo | | Netherlands | 13 | $0.99 | https://cosim.io/en/data-only/nl | | North America (US · CA · MX) | 13 | $3.99 | https://cosim.io/en/data-only/north-america | | Spain | 13 | $0.99 | https://cosim.io/en/data-only/es | | Switzerland | 13 | $0.99 | https://cosim.io/en/data-only/ch | | Thailand | 13 | $1.99 | https://cosim.io/en/data-only/th | | Turkey | 13 | $0.99 | https://cosim.io/en/data-only/tr | | United Arab Emirates | 13 | $3.99 | https://cosim.io/en/data-only/ae | | United Kingdom | 13 | $0.99 | https://cosim.io/en/data-only/gb | | Austria | 12 | $0.99 | https://cosim.io/en/data-only/at | | Belgium | 12 | $0.99 | https://cosim.io/en/data-only/be | ## All 224 Destinations ### Africa (41 destinations) - Africa (29): 3 plans from $17.99 — https://cosim.io/en/data-only/africa-29 - Algeria: 11 plans from $1.99 — https://cosim.io/en/data-only/dz - Angola: 8 plans from $16.99 — https://cosim.io/en/data-only/ao - Benin: 10 plans from $9.99 — https://cosim.io/en/data-only/bj - Botswana: 10 plans from $7.99 — https://cosim.io/en/data-only/bw - Burkina Faso: 9 plans from $9.99 — https://cosim.io/en/data-only/bf - Cameroon: 9 plans from $8.99 — https://cosim.io/en/data-only/cm - Cape Verde: 10 plans from $15.99 — https://cosim.io/en/data-only/cv - Central African Republic: 2 plans from $12.99 — https://cosim.io/en/data-only/cf - Chad: 11 plans from $8.99 — https://cosim.io/en/data-only/td - Cote d'Ivoire: 6 plans from $13.99 — https://cosim.io/en/data-only/ci - Democratic Republic of the Congo: 7 plans from $4.99 — https://cosim.io/en/data-only/cd - Egypt: 10 plans from $3.99 — https://cosim.io/en/data-only/eg - Eswatini: 11 plans from $15.99 — https://cosim.io/en/data-only/sz - Gabon: 11 plans from $7.99 — https://cosim.io/en/data-only/ga - Gambia: 9 plans from $14.99 — https://cosim.io/en/data-only/gm - Ghana: 10 plans from $3.99 — https://cosim.io/en/data-only/gh - Guinea: 8 plans from $11.99 — https://cosim.io/en/data-only/gn - Guinea-Bissau: 9 plans from $10.99 — https://cosim.io/en/data-only/gw - Kenya: 11 plans from $3.99 — https://cosim.io/en/data-only/ke - Liberia: 3 plans from $12.99 — https://cosim.io/en/data-only/lr - Madagascar: 3 plans from $16.99 — https://cosim.io/en/data-only/mg - Malawi: 11 plans from $8.99 — https://cosim.io/en/data-only/mw - Mali: 1 plans from $12.99 — https://cosim.io/en/data-only/ml - Mauritius: 10 plans from $3.99 — https://cosim.io/en/data-only/mu - Morocco: 11 plans from $2.99 — https://cosim.io/en/data-only/ma - Mozambique: 5 plans from $12.99 — https://cosim.io/en/data-only/mz - Niger: 11 plans from $8.99 — https://cosim.io/en/data-only/ne - Nigeria: 9 plans from $4.99 — https://cosim.io/en/data-only/ng - Republic of the Congo: 9 plans from $8.99 — https://cosim.io/en/data-only/cg - Reunion: 11 plans from $0.99 — https://cosim.io/en/data-only/re - Rwanda: 8 plans from $14.99 — https://cosim.io/en/data-only/rw - Senegal: 11 plans from $3.99 — https://cosim.io/en/data-only/sn - Seychelles: 11 plans from $7.99 — https://cosim.io/en/data-only/sc - Sierra Leone: 9 plans from $11.99 — https://cosim.io/en/data-only/sl - South Africa: 10 plans from $2.99 — https://cosim.io/en/data-only/za - Sudan: 2 plans from $14.99 — https://cosim.io/en/data-only/sd - Tanzania: 8 plans from $5.99 — https://cosim.io/en/data-only/tz - Tunisia: 10 plans from $2.99 — https://cosim.io/en/data-only/tn - Uganda: 10 plans from $7.99 — https://cosim.io/en/data-only/ug - Zambia: 11 plans from $7.99 — https://cosim.io/en/data-only/zm ### Americas (50 destinations) - Anguilla: 9 plans from $9.99 — https://cosim.io/en/data-only/ai - Antigua and Barbuda: 9 plans from $10.99 — https://cosim.io/en/data-only/ag - Argentina: 10 plans from $3.99 — https://cosim.io/en/data-only/ar - Aruba: 10 plans from $25.99 — https://cosim.io/en/data-only/aw - Bahamas: 8 plans from $12.99 — https://cosim.io/en/data-only/bs - Barbados: 10 plans from $8.99 — https://cosim.io/en/data-only/bb - Belize: 8 plans from $14.99 — https://cosim.io/en/data-only/bz - Bermuda: 9 plans from $9.99 — https://cosim.io/en/data-only/bm - Bolivia: 5 plans from $14.99 — https://cosim.io/en/data-only/bo - Brazil: 12 plans from $3.99 — https://cosim.io/en/data-only/br - Canada: 15 plans from $0.99 — https://cosim.io/en/data-only/ca - Caribbean (25 areas): 7 plans from $9.99 — https://cosim.io/en/data-only/caribbean - Cayman Islands: 9 plans from $9.99 — https://cosim.io/en/data-only/ky - Chile: 10 plans from $3.99 — https://cosim.io/en/data-only/cl - Colombia: 9 plans from $4.99 — https://cosim.io/en/data-only/co - Costa Rica: 9 plans from $2.99 — https://cosim.io/en/data-only/cr - Curaçao: 10 plans from $8.99 — https://cosim.io/en/data-only/cw - Dominica: 9 plans from $9.99 — https://cosim.io/en/data-only/dm - Dominican Republic: 10 plans from $5.99 — https://cosim.io/en/data-only/do - Ecuador: 10 plans from $3.99 — https://cosim.io/en/data-only/ec - El Salvador: 3 plans from $5.99 — https://cosim.io/en/data-only/sv - French Guiana: 11 plans from $0.99 — https://cosim.io/en/data-only/gf - Grenada: 8 plans from $10.99 — https://cosim.io/en/data-only/gd - Guadeloupe: 10 plans from $1.99 — https://cosim.io/en/data-only/gp - Guatemala: 10 plans from $5.99 — https://cosim.io/en/data-only/gt - Guyana: 10 plans from $9.99 — https://cosim.io/en/data-only/gy - Haiti: 10 plans from $23.99 — https://cosim.io/en/data-only/ht - Honduras: 10 plans from $4.99 — https://cosim.io/en/data-only/hn - Jamaica: 5 plans from $14.99 — https://cosim.io/en/data-only/jm - Martinique: 10 plans from $1.99 — https://cosim.io/en/data-only/mq - Mexico: 12 plans from $0.99 — https://cosim.io/en/data-only/mx - Montserrat: 8 plans from $10.99 — https://cosim.io/en/data-only/ms - Nicaragua: 10 plans from $3.99 — https://cosim.io/en/data-only/ni - North America (US · CA · MX): 13 plans from $3.99 — https://cosim.io/en/data-only/north-america - Panama: 11 plans from $6.99 — https://cosim.io/en/data-only/pa - Paraguay: 10 plans from $5.99 — https://cosim.io/en/data-only/py - Peru: 11 plans from $3.99 — https://cosim.io/en/data-only/pe - Puerto Rico: 2 plans from $5.99 — https://cosim.io/en/data-only/pr - Saint Kitts and Nevis: 8 plans from $10.99 — https://cosim.io/en/data-only/kn - Saint Lucia: 8 plans from $10.99 — https://cosim.io/en/data-only/lc - Saint Vincent and the Grenadines: 8 plans from $12.99 — https://cosim.io/en/data-only/vc - South America (18): 10 plans from $15.99 — https://cosim.io/en/data-only/south-america - South America (6 areas): 12 plans from $7.99 — https://cosim.io/en/data-only/south-america-6 - Suriname: 10 plans from $7.99 — https://cosim.io/en/data-only/sr - Trinidad and Tobago: 8 plans from $12.99 — https://cosim.io/en/data-only/tt - Turks and Caicos Islands: 8 plans from $7.99 — https://cosim.io/en/data-only/tc - USA & Canada: 8 plans from $3.99 — https://cosim.io/en/data-only/usa-canada - United States: 17 plans from $0.99 — https://cosim.io/en/data-only/us - Uruguay: 10 plans from $4.99 — https://cosim.io/en/data-only/uy - Virgin Islands- British: 8 plans from $10.99 — https://cosim.io/en/data-only/vg ### Asia (42 destinations) - Afghanistan: 9 plans from $7.99 — https://cosim.io/en/data-only/af - Armenia: 10 plans from $1.99 — https://cosim.io/en/data-only/am - Asia (20 areas): 8 plans from $4.99 — https://cosim.io/en/data-only/asia-20 - Asia-Pacific (20, incl. AU/NZ): 8 plans from $10.99 — https://cosim.io/en/data-only/asia-pacific - Azerbaijan: 11 plans from $2.99 — https://cosim.io/en/data-only/az - Bangladesh: 10 plans from $1.99 — https://cosim.io/en/data-only/bd - Brunei Darussalam: 8 plans from $5.99 — https://cosim.io/en/data-only/bn - Cambodia: 9 plans from $1.99 — https://cosim.io/en/data-only/kh - Central & South Asia (5): 12 plans from $1.99 — https://cosim.io/en/data-only/central-south-asia - Central Asia (4, incl. Tajikistan): 11 plans from $4.99 — https://cosim.io/en/data-only/central-asia - China & Hong Kong: 1 plans from $8.99 — https://cosim.io/en/data-only/china-hong-kong - China mainland: 13 plans from $1.99 — https://cosim.io/en/data-only/cn - China · Hong Kong · Macao: 12 plans from $2.99 — https://cosim.io/en/data-only/greater-china - China · Japan · Korea: 8 plans from $3.99 — https://cosim.io/en/data-only/china-japan-korea - East & Southeast Asia (12): 9 plans from $5.99 — https://cosim.io/en/data-only/east-southeast-asia - Georgia: 10 plans from $1.99 — https://cosim.io/en/data-only/ge - Hong Kong (China): 12 plans from $1.99 — https://cosim.io/en/data-only/hk - India: 11 plans from $3.99 — https://cosim.io/en/data-only/in - Indonesia: 12 plans from $1.99 — https://cosim.io/en/data-only/id - Japan: 12 plans from $1.99 — https://cosim.io/en/data-only/jp - Japan & Korea: 6 plans from $4.99 — https://cosim.io/en/data-only/japan-south-korea - Kazakhstan: 10 plans from $1.99 — https://cosim.io/en/data-only/kz - Kyrgyzstan: 10 plans from $1.99 — https://cosim.io/en/data-only/kg - Laos: 11 plans from $2.99 — https://cosim.io/en/data-only/la - Macao (China): 13 plans from $1.99 — https://cosim.io/en/data-only/mo - Malaysia: 12 plans from $1.99 — https://cosim.io/en/data-only/my - Maldives: 7 plans from $17.99 — https://cosim.io/en/data-only/mv - Mongolia: 7 plans from $9.99 — https://cosim.io/en/data-only/mn - Nepal: 11 plans from $5.99 — https://cosim.io/en/data-only/np - Pakistan: 10 plans from $1.99 — https://cosim.io/en/data-only/pk - Philippines: 12 plans from $1.99 — https://cosim.io/en/data-only/ph - Singapore: 12 plans from $1.99 — https://cosim.io/en/data-only/sg - Singapore & Malaysia: 3 plans from $2.99 — https://cosim.io/en/data-only/singapore-malaysia - Singapore & Malaysia & Thailand: 8 plans from $1.99 — https://cosim.io/en/data-only/singapore-malaysia-thailand - South Korea: 12 plans from $1.99 — https://cosim.io/en/data-only/kr - Southeast Asia (5: SG/MY/TH/VN/ID): 3 plans from $4.99 — https://cosim.io/en/data-only/southeast-asia-5 - Southeast Asia (7): 10 plans from $2.99 — https://cosim.io/en/data-only/southeast-asia - Sri Lanka: 12 plans from $2.99 — https://cosim.io/en/data-only/lk - Tajikistan: 10 plans from $3.99 — https://cosim.io/en/data-only/tj - Thailand: 13 plans from $1.99 — https://cosim.io/en/data-only/th - Uzbekistan: 10 plans from $1.99 — https://cosim.io/en/data-only/uz - Vietnam: 12 plans from $1.99 — https://cosim.io/en/data-only/vn ### Europe (58 destinations) - Aland Islands: 9 plans from $2.99 — https://cosim.io/en/data-only/ax - Albania: 11 plans from $1.99 — https://cosim.io/en/data-only/al - Andorra: 10 plans from $3.99 — https://cosim.io/en/data-only/ad - Austria: 12 plans from $0.99 — https://cosim.io/en/data-only/at - Belarus: 10 plans from $1.99 — https://cosim.io/en/data-only/by - Belgium: 12 plans from $0.99 — https://cosim.io/en/data-only/be - Bosnia and Herzegovina: 11 plans from $2.99 — https://cosim.io/en/data-only/ba - Bulgaria: 13 plans from $0.99 — https://cosim.io/en/data-only/bg - Croatia: 12 plans from $0.99 — https://cosim.io/en/data-only/hr - Cyprus: 12 plans from $0.99 — https://cosim.io/en/data-only/cy - Czech Republic: 12 plans from $0.99 — https://cosim.io/en/data-only/cz - Denmark: 12 plans from $0.99 — https://cosim.io/en/data-only/dk - Estonia: 12 plans from $0.99 — https://cosim.io/en/data-only/ee - Europe (30+ areas): 15 plans from $1.99 — https://cosim.io/en/data-only/europe-30 - Europe (33 areas): 10 plans from $1.99 — https://cosim.io/en/data-only/europe-33 - Europe (35 areas): 12 plans from $1.99 — https://cosim.io/en/data-only/europe-35 - Europe (42 areas): 10 plans from $4.99 — https://cosim.io/en/data-only/europe-42 - Europe (43 areas): 7 plans from $9.99 — https://cosim.io/en/data-only/europe-43 - Europe (7): 8 plans from $4.99 — https://cosim.io/en/data-only/europe-7 - Faroe Islands: 11 plans from $1.99 — https://cosim.io/en/data-only/fo - Finland: 12 plans from $0.99 — https://cosim.io/en/data-only/fi - France: 12 plans from $1.99 — https://cosim.io/en/data-only/fr - Germany: 13 plans from $0.99 — https://cosim.io/en/data-only/de - Gibraltar: 9 plans from $5.99 — https://cosim.io/en/data-only/gi - Greece: 13 plans from $0.99 — https://cosim.io/en/data-only/gr - Greenland: 7 plans from $16.99 — https://cosim.io/en/data-only/gl - Guernsey: 4 plans from $8.99 — https://cosim.io/en/data-only/gg - Hungary: 12 plans from $0.99 — https://cosim.io/en/data-only/hu - Iceland: 12 plans from $1.99 — https://cosim.io/en/data-only/is - Ireland: 12 plans from $0.99 — https://cosim.io/en/data-only/ie - Ireland & Slovenia: 7 plans from $2.99 — https://cosim.io/en/data-only/ireland-slovenia - Isle of Man: 8 plans from $1.99 — https://cosim.io/en/data-only/im - Italy: 13 plans from $0.99 — https://cosim.io/en/data-only/it - Jersey: 9 plans from $1.99 — https://cosim.io/en/data-only/je - Latvia: 11 plans from $1.99 — https://cosim.io/en/data-only/lv - Liechtenstein: 11 plans from $1.99 — https://cosim.io/en/data-only/li - Lithuania: 12 plans from $0.99 — https://cosim.io/en/data-only/lt - Luxembourg: 12 plans from $0.99 — https://cosim.io/en/data-only/lu - Malta: 10 plans from $1.99 — https://cosim.io/en/data-only/mt - Moldova: 11 plans from $0.99 — https://cosim.io/en/data-only/md - Monaco: 9 plans from $28.99 — https://cosim.io/en/data-only/mc - Montenegro: 10 plans from $1.99 — https://cosim.io/en/data-only/me - Netherlands: 13 plans from $0.99 — https://cosim.io/en/data-only/nl - North Macedonia: 11 plans from $2.99 — https://cosim.io/en/data-only/mk - Norway: 12 plans from $0.99 — https://cosim.io/en/data-only/no - Poland: 12 plans from $0.99 — https://cosim.io/en/data-only/pl - Portugal: 12 plans from $0.99 — https://cosim.io/en/data-only/pt - Romania: 12 plans from $0.99 — https://cosim.io/en/data-only/ro - Russia: 9 plans from $2.99 — https://cosim.io/en/data-only/ru - Serbia: 10 plans from $1.99 — https://cosim.io/en/data-only/rs - Slovakia: 11 plans from $1.99 — https://cosim.io/en/data-only/sk - Slovenia: 12 plans from $0.99 — https://cosim.io/en/data-only/si - Spain: 13 plans from $0.99 — https://cosim.io/en/data-only/es - Sweden: 11 plans from $0.99 — https://cosim.io/en/data-only/se - Switzerland: 13 plans from $0.99 — https://cosim.io/en/data-only/ch - UK & Ireland: 5 plans from $3.99 — https://cosim.io/en/data-only/uk-ireland - Ukraine: 11 plans from $0.99 — https://cosim.io/en/data-only/ua - United Kingdom: 13 plans from $0.99 — https://cosim.io/en/data-only/gb ### Global (2 destinations) - Global (120 areas): 9 plans from $13.99 — https://cosim.io/en/data-only/global-120 - Global (139 areas): 6 plans from $22.99 — https://cosim.io/en/data-only/global-139 ### Middle-east (14 destinations) - Bahrain: 10 plans from $3.99 — https://cosim.io/en/data-only/bh - Gulf (6, incl. Iraq): 8 plans from $5.99 — https://cosim.io/en/data-only/gulf - Gulf States — GCC (6): 5 plans from $11.99 — https://cosim.io/en/data-only/gcc - Iraq: 10 plans from $3.99 — https://cosim.io/en/data-only/iq - Israel: 11 plans from $2.99 — https://cosim.io/en/data-only/il - Jordan: 10 plans from $3.99 — https://cosim.io/en/data-only/jo - Kuwait: 11 plans from $2.99 — https://cosim.io/en/data-only/kw - Middle East & Caucasus (11): 3 plans from $21.99 — https://cosim.io/en/data-only/middle-east-caucasus - Middle East & North Africa (12): 5 plans from $21.99 — https://cosim.io/en/data-only/middle-east-north-africa - Oman: 11 plans from $2.99 — https://cosim.io/en/data-only/om - Qatar: 10 plans from $3.99 — https://cosim.io/en/data-only/qa - Saudi Arabia: 11 plans from $2.99 — https://cosim.io/en/data-only/sa - Turkey: 13 plans from $0.99 — https://cosim.io/en/data-only/tr - United Arab Emirates: 13 plans from $3.99 — https://cosim.io/en/data-only/ae ### Oceania (6 destinations) - Australia: 13 plans from $1.99 — https://cosim.io/en/data-only/au - Australia & New Zealand: 10 plans from $3.99 — https://cosim.io/en/data-only/australia-new-zealand - Fiji: 10 plans from $4.99 — https://cosim.io/en/data-only/fj - French Polynesia: 11 plans from $22.99 — https://cosim.io/en/data-only/pf - Guam: 11 plans from $7.99 — https://cosim.io/en/data-only/gu - New Zealand: 11 plans from $1.99 — https://cosim.io/en/data-only/nz ### Other (11 destinations) - Australia · UK · USA: 2 plans from $9.99 — https://cosim.io/en/data-only/australia-uk-usa - Bhutan: 10 plans from $7.99 — https://cosim.io/en/data-only/bt - Ethiopia: 10 plans from $11.99 — https://cosim.io/en/data-only/et - Libya: 9 plans from $16.99 — https://cosim.io/en/data-only/ly - Mayotte: 10 plans from $1.99 — https://cosim.io/en/data-only/yt - Saint Barthelemy: 10 plans from $1.99 — https://cosim.io/en/data-only/bl - Saint Martin: 10 plans from $1.99 — https://cosim.io/en/data-only/mf - Samoa: 8 plans from $7.99 — https://cosim.io/en/data-only/ws - San Marino: 10 plans from $1.99 — https://cosim.io/en/data-only/sm - Vatican City: 10 plans from $1.99 — https://cosim.io/en/data-only/va - Venezuela: 10 plans from $23.99 — https://cosim.io/en/data-only/ve ## 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 - `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 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. **Install deadline**: eSIMs must be installed within `installValidity.days` days of purchase (some coupons shorten this window). Uninstalled eSIMs are automatically cancelled after the deadline — which also ends refund eligibility. Relay `installValidity.note` (e.g. "install by 2026-08-01") 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 ### World Cup 2026 travel eSIM bundle Discounted eSIMs for the US, Mexico, and Canada during the FIFA World Cup 2026. Landing page shows the current featured SKUs and the promo codes for each tier. - **How to apply:** Direct the user to the landing page below — it lists the current featured SKUs and coupon codes. - **Scope:** United States, Mexico, Canada - **Landing page:** https://cosim.io/en/campaign/world-cup-2026 - **Valid:** 2026-06-01T00:00:00Z → 2026-07-31T23:59:59Z (9 days remaining) ## How It Works 1. Choose a plan — Browse Data Only or Global Prepaid plans 2. Install eSIM — Scan the QR code (takes 2 minutes) 3. Connect — Arrive at destination and use mobile data instantly ## Key Features - 224+ 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 - RSS Feed: https://cosim.io/feed/blog.xml ## Important Pages - Homepage: https://cosim.io - Data Only Plans: https://cosim.io/en/data-only - Global Prepaid: https://cosim.io/en/global-prepaid - Coverage Map: https://cosim.io/en/coverage - FAQ: https://cosim.io/en/faq - Install Guide: https://cosim.io/en/resources/install-guide - Supported Devices: https://cosim.io/en/resources/supported-devices - Full documentation: https://cosim.io/llms-full.txt - OpenAPI spec: https://cosim.io/openapi.yaml ## Languages Available in: English, 繁體中文, 简体中文, 日本語, 한국어, Français ## Contact - Live chat: Available on website (24/7) - Website: https://cosim.io