---
title: "Get a biller's verifications"
method: GET
path: "/billers/{billerId}/verifications"
tags: ["Verifications"]
---

# Get a biller's verifications

`GET /billers/{billerId}/verifications`

Returns the biller's verification history, latest first.

`checks[]` is ordered and open. Checks may be added, removed or reordered, so an
integration must not switch exhaustively on `key` or fail on an unrecognised one.

A check that does not apply to a biller is left out of the list rather than sent with a
status. A missing key means only that Adfin is not asking this biller for it right now.

## Path parameters

- `billerId` string, uuid, required

## Response `200`

Verifications retrieved successfully.

- BillerVerificationsResponse — Every verification of a biller.
  - `verifications` BillerVerificationResponse[], required — The biller's verification history, latest first.
    - `verificationId` string, uuid, required — The unique identifier of the verification.
    - `type` 'ONBOARDING' | 'REVERIFICATION', required — The type of verification.
    - `status` 'NOT_STARTED' | 'OUTSTANDING' | 'COMPLETED' | 'IN_REVIEW' | 'ACTION_REQUIRED' | 'APPROVED' | 'REJECTED' | 'SUSPENDED', required — The overall status, rolled up from the checks.
    - `waitingOn` 'BILLER' | 'ADFIN' — Who has to act next. Omitted when nobody has to act.
    - `creationTime` string, date-time, required — When the verification was created.
    - `checks` VerificationCheck[], required — The checks that make up the verification, in the order a biller works through them.
      - `key` 'BUSINESS_DETAILS' | 'BUSINESS_ADDRESS' | 'DOCUMENTS' | 'BANK_ACCOUNT' | 'DECISION_MAKERS' | 'IDENTITY_VERIFICATION' | 'TERMS_AND_CONDITIONS' | 'DIRECT_DEBIT_REVIEW', required — What this check covers.
      - `status` 'NOT_STARTED' | 'OUTSTANDING' | 'COMPLETED' | 'IN_REVIEW' | 'ACTION_REQUIRED' | 'APPROVED' | 'REJECTED' | 'SUSPENDED', required — The status of this check.
      - `waitingOn` 'BILLER' | 'ADFIN' — Who has to act on this check. Omitted when nobody has to act.
      - `detail` string — Information on why the check is in this status.

## Other responses

- `401` — Authentication required - Invalid or missing authorisation headers.
- `404` — No verifications are available for this 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/verifications/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)