v1 API

Embed eSIMs in your travel product

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

Create an order, get a QR back

One call, one webhook. Sandbox and live keys available on request.

POST /v1/orders

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

Where developers ship Roameo

Airline check-in flows

Surface a destination eSIM offer at boarding-pass print or web check-in.

OTA upsells

Bundle data with flights, hotels and tours — one webhook back to your order system.

Neobank perks

Auto-provision an eSIM the moment your cardholder swipes a foreign-currency transaction.

Freight ops dashboards

Equip drivers crossing borders with country-specific data, billed back to dispatch.

How it scales

Production-ready out of the gate

Rate-limited but generous

300 requests/minute on the standard tier, burst up to 1,000. Higher tiers on request.

Idempotency keys

Every write endpoint accepts an Idempotency-Key header — safe to retry on network blips.

Webhook events

Receive order.created, order.installed, usage.threshold and order.expired in real time.

Get access

Ready to build?

Drop us a line — we'll send sandbox keys and a calendar link within 48 hours.