Build on Num
Two HTTP APIs, both bearer-key, JSON in and out, priced in US dollars. One issues eSIMs for you; the other tells you what happened to orders your customers paid for through a Num payment link.
Quickstart
- Sign up. Your sandbox account exists immediately, with $100 of test credit. No approval.
- In the console, create a
numk_test_key. - Call the API. The example prices Japan, then places a sandbox order that returns a demo activation code and a QR image.
curl "https://numesim.uk/v1/catalog?country=JP" \
-H "Authorization: Bearer numk_test_…"
curl -X POST https://numesim.uk/v1/orders \
-H "Authorization: Bearer numk_test_…" \
-H "Idempotency-Key: order-0001" \
-H "Content-Type: application/json" \
-d '{"planId":"np_…","country":"JP","funding":"credit"}'
Sandbox eSIMs are not real. They are demo codes that will not install on a phone. Everything else behaves exactly as live.
Download the partner guide (PDF): the process, billing, the full API reference and the terms in one document you can share internally. Also available as a print version.
Getting production-ready
The reference lists every case your code must handle and the header that triggers each one in sandbox: a short balance, a failed order, a delayed eSIM. Your console keeps a go-live checklist that ticks itself as your integration exercises them, and GET /v1/readiness returns the same list.
Going live
There is no approval step. Finish the go-live checklist in sandbox, confirm your login email, and add your first credit by card from the console: minimum $50 per top-up, the card processing fee added at checkout, and the credit added automatically within seconds. The moment Stripe confirms the payment, the credit is posted, live is switched on for your account and an account.live webhook fires. Invoice billing and volume pricing are available by arrangement; ask from the console. Credit is prepaid and non-refundable. Nothing in your integration changes except the key prefix. See how onboarding and billing work and the API Terms.
Contact
Integration questions and account approval: [email protected]. Quote your company name and, for order issues, the order id and UTC timestamp.