Connecting you to the world
Connecting you to the world
One REST endpoint, idempotency-safe, webhook-driven. Provision a global eSIM and ship the QR back to your customer in under five seconds.
Quick start
One call, one webhook. Sandbox and live keys available on request.
curl -X POST https://api.roameoesim.com/v1/orders \
-H "Authorization: Bearer $ROAMEO_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"country": "JP",
"planId": "jp-10gb-30d",
"traveler": {
"email": "[email protected]",
"reference": "TRIP-2026-0042"
}
}'Response
{
"id": "ord_01HXY8K3VWQ5N7M9",
"status": "active",
"country": "JP",
"planId": "jp-10gb-30d",
"qrCodeUrl": "https://cdn.roameoesim.com/qr/ord_01HXY8K3VWQ5N7M9.png",
"activationCode": "LPA:1$rsp.roameoesim.com$04386-AGYFT-A74Y8-3F815",
"expiresAt": "2026-06-24T09:30:00Z"
}Use cases
Surface a destination eSIM offer at boarding-pass print or web check-in.
Bundle data with flights, hotels and tours — one webhook back to your order system.
Auto-provision an eSIM the moment your cardholder swipes a foreign-currency transaction.
Equip drivers crossing borders with country-specific data, billed back to dispatch.
How it scales
300 requests/minute on the standard tier, burst up to 1,000. Higher tiers on request.
Every write endpoint accepts an Idempotency-Key header — safe to retry on network blips.
Receive order.created, order.installed, usage.threshold and order.expired in real time.
Get access
Drop us a line — we'll send sandbox keys and a calendar link within 48 hours.