API reference
Every endpoint in the Tizon Mobile API, with a playground you can send requests from.
One base URL, https://api.tizon.mobile, and the API key decides the mode —
see authentication.
Each page carries a playground. It sends through this site rather than straight from your browser, so a test key works without any CORS setup of your own.
Download the spec
The same API as a file, to import into your own tools.
openapi.jsonOpenAPI 3.1 · JSON
Import it into Postman, Insomnia or Bruno, or generate a client from it.
openapi.yamlOpenAPI 3.1 · YAML
The same spec, for tools and people that read YAML.
tizon.postman_collection.jsonPostman v2.1
Every endpoint, with your key in one variable and a fresh Idempotency-Key on each send.
Tools that import from a URL can take https://docs.tizon.mobile/openapi.json
directly, and stay current by importing it again.
Endpoints
Offers
The catalog: eSIM plans and mobile top-ups, each with the price your wallet will be debited.
Wallet
The account's closed-loop USD balance: what it holds, what it can spend, and every movement.
Account
The account an API key belongs to, and its credit terms: how far below zero the wallet may go, and for how long.
Quotes
A quote prices an offer and pays for it.
Revenue
A partner's Revenue Centre: what they have earned on the orders they brought, and turning it into credit they can spend.
Orders
The fulfillment of a paid quote, and its eSIM or top-up receipt.
Test helpers
Sandbox tools that make things happen without real money.
Webhooks
Endpoints Tizon delivers events to.