# Quote airtime (/docs/api-reference/airtime/quote)

`POST /v1/airtime/quote`

Prices the order body with current prices, without placing an order.

Takes the same body as order and resolves the number's operator as the order does, with a carrier lookup per
item. Each item is priced on its own, in request order; the first failing item aborts the quote and is named at
`items[i]`, for example 409 / 11002 at `items[i].inputs.maxPrice` when the current price is above
it. 409 / 20000 means the lookup shows that the offer's operator cannot be the number's: search again. A
carrier lookup that fails gives 503 / 10007. A quote reserves nothing and does not expire; to hold the quoted
price, send it as `inputs.maxPrice` in the order.

## Request body

- `application/json`: `AirtimeOrderRequest`
- `text/json`: `AirtimeOrderRequest`
- `application/*+json`: `AirtimeOrderRequest`

## Responses

### 200

OK

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

### 400

Invalid partner request or model validation failure.

- `application/json`: `ErrorResponse`

### 409

Conflict

- `text/plain`: `ErrorResponse`
- `application/json`: `ErrorResponse`
- `text/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.