# Airtime catalog (/docs/api-reference/airtime/catalog)

`GET /v1/airtime/catalog`

Returns the operator directory, page by page, for partner inventory.

Returns `{ items: [{ id, name, countryCode, category, logoUrl }], nextCursor }`, ordered by operator ID.
Pass `nextCursor` back as `cursor` with the same `countryCode` until it is null; a page can hold
fewer items than `limit`, and the cursor does not expire. A cursor reused with another `countryCode`,
or a blank or invalid `countryCode`, gives 400 / 10001. Offers are not exported: they depend on whether
the operator is detected or chosen, so read them with `operators/{id}?phoneNumber=`.

## Parameters

| Name | In | Required | Type | Description |
|---|---|---|---|---|
| `countryCode` | query | no | `string` | Optional ISO 3166-1 alpha-2 country filter, in either case; every country when omitted. A blank or invalid value gives 400 / 10001. |
| `cursor` | query | no | `string` | The `nextCursor` of the previous page; omit it for the first page. Reuse it only with the same `countryCode`. |
| `limit` | query | no | `integer` | Page size, 1 to 100; default 100. |

## Responses

### 200

OK

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

### 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.