List mobile networks
Lists mobile network codes (MCC/MNC) with their operator, country and calling code.
Lists mobile network codes (MCC/MNC) with their operator, country and calling code.
Returns { items } ordered by mcc then mnc, without paging. Optional filters:
countryCode (ISO 3166-1 alpha-2, either case) and mcc (3 digits); both together return the
networks matching both. A malformed filter or an unknown query parameter returns 400 with code
10001.
PartnerApiKeyX-Partner-Key<token>Partner API Key (X-Partner-Key)
countryCode?stringOnly networks of this country: an ISO 3166-1 alpha-2 code, in either case.
mcc?stringOnly networks with this 3-digit mobile country code, for example 400.
OK
- response
Mobile network codes ordered by MCC then MNC. The list is a few thousand rows of reference data, so it is not paged.
items*array<>curl -X GET 'https://api.sandbox.openroam.com/v1/common/mccmnc?mcc=400'{ "items": [ { "mcc": "string", "mnc": "string", "countryCode": "string", "countryName": "string", "operator": "string", "dialCode": "string" } ]}List countries GET
Lists every country and territory with its codes, English name, calling code and flag. Returns `{ items }`, the whole list ordered by `countryCode`, without paging. `countryCode` is the ISO 3166-1 alpha-2 code every service filters and reports by. The endpoint takes no query parameters; an unknown parameter returns `400` with code `10001`.
Order eSIMs POST
Places an order for new eSIMs or a top-up and returns the accepted order. Takes the same body as quote and needs the `manage` order permission (403 / 10003 without it). An `Idempotency-Key` header with a new UUID is required for every purchase: a retry with the same key and body returns the order already accepted, 409 / 12002 with `Retry-After` while it is still being accepted, and a changed body gives 409 / 12001. A top-up is an offer from `search?iccid=` ordered with `inputs.iccid` and quantity 1; without `inputs.iccid` the same offer is bought as a new eSIM. A new eSIM is instant unless `inputs.isInstant` is false, which delivers an entitlement to provision later. Every price is recalculated: a current price above `inputs.maxPrice` gives 409 / 11002 before anything is charged. A wallet charge that fails creates no order and gives 402 / 16000, with `details[0]` naming `wallet` and `INSUFFICIENT_BALANCE` or `WALLET_BLOCKED`; send the same request with the same key after a top-up. An unknown or foreign `inputs.iccid` gives 404 / 10004 and charges nothing.