# Search billers (/docs/api-reference/utility/search)

`GET /v1/utility/search`

Searches the billers of a country and returns them with their offers, one page at a time.

Returns `{ items, pagination }`. `countryCode` is required; `category`, `serviceType` and
`q` select billers. Utility has no value or price filter. Pages count billers that still have an offer,
and prices are indicative, in `currency`. Quote and order take an offer's `publicId`, never the
biller's `id`. An invalid or unknown parameter gives 400 / 10001; an unsupported `currency` gives
404 / 10004.

## Parameters

| Name | In | Required | Type | Description |
|---|---|---|---|---|
| `countryCode` | query | yes | `string` | Required ISO 3166-1 alpha-2 country code of the billers, in either case. |
| `category` | query | no | `string` | Keep the billers of this category, for example `electricity`. |
| `serviceType` | query | no | `string` | Keep `prepaid` or `postpaid` billers. |
| `q` | query | no | `string` | Text in the biller name, case-insensitive; at most 100 characters, without control characters. |
| `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`. |
| `page` | query | no | `integer` | Page number, from 1; default 1. |
| `limit` | query | no | `integer` | Page size, 1 to 100; default 10. |

## Responses

### 200

OK

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

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