List airtime operators
Lists the operators of a country that the customer can choose manually (manual flow, step 1).
Lists the operators of a country that the customer can choose manually (manual flow, step 1).
Returns the complete list, without paging or prices, as
{ items: [{ id, name, countryCode, category, logoUrl }] }, ordered by name. Only operators with an
offer that can be sold for a chosen operator are listed. An invalid countryCode gives 400 / 10001.
Continue with operators/{id}?phoneNumber=.
PartnerApiKeyX-Partner-Key<token>Partner API Key (X-Partner-Key)
countryCode*stringRequired ISO 3166-1 alpha-2 country code, in either case, for example the details.phoneLookup.countryCode of a search.
OK
- response
The complete operator list of one country for manual selection; it is small, so it is not paged.
items*array<>curl -X GET 'https://api.sandbox.openroam.com/v1/airtime/operators?countryCode=AZ'{ "items": [ { "id": "string", "name": "string", "countryCode": "string", "category": "string", "logoUrl": "string" } ]}Get an airtime operator GET
Returns one operator with its offers for a phone number of its country (manual flow, step 2). Returns the operator in the item shape that search returns, without a carrier lookup. A number of another country than the operator's gives 400 / 10001 with `COUNTRY_MISMATCH` at `phoneNumber`. An unknown ID, including any value that is not an operator ID, or an operator without an orderable offer, gives 404 / 10004. Offer filters that match none of the operator's offers leave `offers` empty. A manual choice is not checked against the number's carrier, so have the customer confirm the operator before ordering.
Look up a phone number GET
Describes a phone number and returns its carrier from a carrier lookup when the number is valid. Describes the number from numbering-plan data and, for a valid number, adds carrier information from a live carrier lookup. A number without the international shape gives 400 / 10001; a number its country does not assign returns 200 with `isValid: false` and `carrier: null`, without a carrier lookup. Returns 503 / 10007 when the carrier lookup is unavailable. The carrier is for display only and nothing is stored; use search to find a sellable operator.