---
title: "List billers"
method: GET
path: "/bill-payments/billers"
tags: ["Bill Payments"]
---

# List billers

`GET /bill-payments/billers`

## Request

- The document declares no server URL.
- Auth: none declared. Required headers: `ApiKey`, `MerchantId`, `Environment`

Lists the billers the merchant can pay bills to, optionally filtered by country and category.

## Query parameters

- `country` string
- `category` string

## Headers

- `ApiKey` string, required
- `MerchantId` string, required
- `Environment` 'live' | 'sandbox', required

## Response `200`

- BillerDto[]
  - `identifier` string, required
  - `name` string, required
  - `country` string, required
  - `category` string, required
  - `flow` 'INVOICE' | 'CONTRACT', required
  - `reference_rule` BillerReferenceRuleDto, required
    - `code` string, required
    - `label` string, required
    - `description` string, required
    - `regex` string, required
    - `example` string, required
  - `payment_mandatory_data` string[], required
  - `logo` string, required

## Other responses

- `400`: Bad Request
- `401`: Wrong credentials
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity
- `429`: ThrottlerException: Too Many Requests
- `500`: Internal error
- `502`: Invalid gateway

## Changes

- **2026-11-03** `f6d3f87df5e0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hub2/apis/hub2-service-api/changes/bill-payments/billers/get.md)

---

[API](https://skmtc.dev/hub2/apis/hub2-service-api.md) - [All operations](https://skmtc.dev/hub2/apis/hub2-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hub2/apis/hub2-service-api/revisions/f6d3f87df5e0?raw)