Partner API

Sell eSIMs under your own brand.

One REST API for the wholesale catalogue, instant back-to-back provisioning and live usage. Build against the free sandbox today — no account, no card, no waiting.

Try the sandbox Request live access

Base currency: EUR
Settlement: Per-currency balances
Provisioning: Instant, back-to-back
Coverage: 190+ destinations

Authentication

Every request carries a bearer token. Live keys start with sb_partner_ and are issued by us when your partner account is approved. Sandbox keys start with sb_sandbox_ and work immediately.

Keys are hashed at rest and can be rotated or revoked at any time.
All traffic is TLS-only; CORS is open so you can call from server or browser.
Send a unique reference per order — it acts as the idempotency key.

Authorization header

curl https://www.skybytesim.com/api/public/partner/catalogue \
  -H "Authorization: Bearer sb_partner_your_key_here"

Endpoints

Base URL https://www.skybytesim.com. Prefix any path with /sandbox after /partner to hit the simulator.

GET/api/public/partner/catalogue

Your wholesale price list, priced in your billing currency with your margin applied.

country (ISO-2, optional) · limit (max 500)

POST/api/public/partner/orders

Buy a bundle back-to-back. We provision with the upstream carrier and return the eSIM activation details.

sku · quantity (1-10) · reference · customer_email

GET/api/public/partner/esims

Status, data usage and expiry for eSIMs on your own orders.

order_id or iccid

Sandbox

The sandbox mirrors the live API exactly — same paths, same payloads, same error codes — but nothing is charged, provisioned or booked to a ledger. Use the public demo key below, or any key you invent that starts with sb_sandbox_.

1 · Fetch the sandbox catalogue

curl https://www.skybytesim.com/api/public/partner/sandbox/catalogue \
  -H "Authorization: Bearer sb_sandbox_demo"

2 · Place a sandbox order

curl -X POST https://www.skybytesim.com/api/public/partner/sandbox/orders \
  -H "Authorization: Bearer sb_sandbox_demo" \
  -H "Content-Type: application/json" \
  -d '{"sku":"SBX-PT-5GB-30D","quantity":1,"reference":"my-test-1"}'

3 · Check status and usage

curl "https://www.skybytesim.com/api/public/partner/sandbox/esims?order_id=sbx_ord_my-test-1" \
  -H "Authorization: Bearer sb_sandbox_demo"

4 · Force an error path

# SBX-FAIL-CREDIT     -> 402 credit_limit_exceeded
# SBX-FAIL-PROVISION  -> 502 provisioning_failed
# SBX-FAIL-NOTFOUND   -> 404 sku_not_found
curl -X POST https://www.skybytesim.com/api/public/partner/sandbox/orders \
  -H "Authorization: Bearer sb_sandbox_demo" \
  -H "Content-Type: application/json" \
  -d '{"sku":"SBX-FAIL-CREDIT","quantity":1}'

Errors

401 unauthorized	Missing, revoked or malformed API key.
400 invalid_body	Body failed validation — check field names and types.
404 sku_not_found	The SKU is unknown or no longer active.
402 credit_limit_exceeded	The order exceeds your available credit line.
502 provisioning_failed	Upstream carrier failed. The order is returned with detail; retry with the same reference.

Ready to go live?

Live access includes a wholesale margin tuned to your volume, a credit line, per-currency settlement and a named account manager. Tell us your expected volume and target markets and we'll issue your keys.

Apply for a partner account Talk to support