# Get an airtime operator (/docs/api-reference/airtime/get-operator)

`GET /v1/airtime/operators/{id}`

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.

## Parameters

| Name | In | Required | Type | Description |
|---|---|---|---|---|
| `id` | path | yes | `string` | The operator ID (`operator_…`) from the operator list, the catalog or search. |
| `phoneNumber` | query | yes | `string` | The recipient's number in international format, starting with + or 00. It must belong to the operator's country. |
| `valueType` | query | no | `string` | Keep only `fixed` or only `range` offers. |
| `valueCurrency` | query | no | `string` | Currency of `minValue` and `maxValue`, three letters; required with either of them. |
| `minValue` | query | no | `number` | Keep the offers whose value reaches at least this amount, in `valueCurrency`. |
| `maxValue` | query | no | `number` | Keep the offers whose value starts at or below this amount, in `valueCurrency`. |
| `minPrice` | query | no | `number` | Keep the offers whose indicative price reaches at least this amount, in the price currency. |
| `maxPrice` | query | no | `number` | Keep the offers whose indicative price starts at or below this amount, in the price currency. A filter, not the `inputs.maxPrice` limit of a purchase. |
| `currency` | query | no | `string` | Price currency, three letters in either case; the API key's currency when omitted. An unsupported code gives 400 / 10001 at `currency`, reason `NOT_SUPPORTED`. |

## Responses

### 200

OK

- `text/plain`: `AirtimeOperator`
- `application/json`: `AirtimeOperator`
- `text/json`: `AirtimeOperator`

### 400

Invalid partner request or model validation failure.

- `application/json`: `ErrorResponse`

### 429

Too many requests from this IP address. Wait for Retry-After seconds, then send the same request again; an order keeps its Idempotency-Key and body.

- `application/json`: `ErrorResponse`

The full schemas are in the OpenAPI specification at /openapi.json.