---
title: "Retrieves the payment capabilities of a biller"
method: GET
path: "/billers/{billerId}/payment_capabilities"
tags: ["Biller"]
---

# Retrieves the payment capabilities of a biller

`GET /billers/{billerId}/payment_capabilities`

Returns the payment capabilities that apply to the biller, each with its status.

A capability that does not apply is left out of the list rather than sent with a status.
A missing capability means only that Adfin does not offer it to this biller right now.
It is not a rejection, and the list length is not a fixed denominator.

## Path parameters

- `billerId` string, uuid, required

## Response `200`

The payment capabilities retrieved successfully.

- BillerPaymentCapabilitiesResponse — The payment capabilities of a biller and whether each one can be used.
  - `lastUpdatedTime` string, date-time — When the biller's capability record last changed.
  - `paymentCapabilities` PaymentCapabilityResponse[], required — The payment capabilities that apply to the biller, each with its status.
    - `capability` 'CARD' | 'DIRECT_DEBIT' | 'PAY_BY_BANK' | 'PAYOUTS' | 'BANK_TRANSFER' | 'PAYMENT_OVER_THE_PHONE', required — The payment capability.
    - `status` 'VALID' | 'PENDING' | 'INVALID' | 'REJECTED' | 'RESTRICTED', required — Whether the capability can be used.

## Other responses

- `401` — Authentication required - Invalid or missing authorisation headers.
- `403` — The access token belongs to another biller.
- `500` — The server could not process the request.

## Changes

- **2026-08-29** `53d29f0850e0` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/adfin/apis/adfin-api/changes/billers/:billerId/payment_capabilities/get.md)

---

[API](https://skmtc.dev/adfin/apis/adfin-api.md) · [All operations](https://skmtc.dev/adfin/apis/adfin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adfin/adfin-api/revisions/e2d72caddef0/schema)