YonoSIM API · Live · Self-serve

Ship eSIM in your app in 15 minutes.

Without an Airalo Partners NDA, a Twilio-Super-SIM contract, or wiring raw wholesale supply yourself. Public rate exposed in the API, sandbox key in your inbox in seconds, go-live when you’re ready. One rate, no minimum, no sales call.

API online
→

Interactive playground

Try every endpoint in your browser. Real responses against your account.

 →

OpenAPI 3.1 spec

Full machine-readable schema. Auto-generate SDKs from it.

 →

npm — @yonosim/api

Scope reserved. Full generated TypeScript SDK ships alongside the first partner integration.

 →

Health check

Live status + version + mode.

 →

Marketing site

Pricing, comparison, and how to request access.

Try it in 30 seconds

# List every supported country + region

curl "https://api.yonosim.com/v1/countries" \
  -H "Authorization: Bearer sk_test_growth_daf7d4add37757f28cb4c9e020b41da3fd0aca463ee0af0b"

# Search plans for Japan, minimum 5 GB

curl "https://api.yonosim.com/v1/plans/search" \
  -H "Authorization: Bearer sk_test_growth_daf7d4add37757f28cb4c9e020b41da3fd0aca463ee0af0b" \
  -H "Content-Type: application/json" \
  -d '{"country":"JP","minDataGb":5}'

# Create an eSIM order (returns QR + LPA)

curl "https://api.yonosim.com/v1/orders" \
  -H "Authorization: Bearer sk_test_growth_daf7d4add37757f28cb4c9e020b41da3fd0aca463ee0af0b" \
  -H "Content-Type: application/json" \
  -d '{"planId":"JC065","customerEmail":"traveler@example.com"}'

# Check real-time data usage (updates on each read)

curl "https://api.yonosim.com/v1/orders/ord_RtFSRxfGapnI/usage" \
  -H "Authorization: Bearer sk_test_growth_daf7d4add37757f28cb4c9e020b41da3fd0aca463ee0af0b"

Want to try the other endpoints without typing bearer tokens? The interactive playground at api.yonosim.com/docs has a Test Request button on every route — auth pre-filled, real responses.

Authentication

What token do I use?

The examples above use a shared public demo key (sk_test_growth_daf7d…) with $20 of rotating test credit — please don't drain it. For your own sandbox key with $10 of dedicated credit, request access at yonosim.com/developers (24-hour turnaround). Every partner pays the same published retail rate — the same number a traveler sees on yonosim.com/plans. Volume rebates against retail available on request at ~$10k+/mo; email partner@yonosim.com.

Where do my orders live?

Postgres, scoped to your API key. Orders, usage, and refunds persist across restarts and are visible via GET /v1/orders. Sandbox keys (sk_test_*) run in an isolated test namespace and don't touch live provisioning.

How do I get real credentials?

Request access at yonosim.com/developers. We reply within 24 hours with a sandbox key.

✓ Copied to clipboard