---
title: "Confirmation of Payee"
method: POST
path: "/tools/confirmation-of-payee"
tags: ["Tools"]
---

# Confirmation of Payee

`POST /tools/confirmation-of-payee`

Verify your payee's account details before adding them to our system or initiating a payment.

## Headers

- `Company-Id` string, uuid

## Request body

- object
  - `scheme` 'faster_payments' — Specifies the payment scheme to be used. The only accepted value is `faster_payments`.
  - `sort_code` string — The 6-digit sort code of the bank account. Must only contain numeric characters.
  - `account_number` string — The 8-digit account number. Must only contain numeric characters.
  - `account_name` string — The name on the bank account. Can include letters, spaces, periods, and hyphens.
  - `account_type` 'personal' | 'business' — Specifies the type of account. Acceptable values are "personal" or "business".

## Response `201`

Created

- object
  - `id` string, uuid — A unique identifier assigned by Acquired.com to the Confirmation of Payee request.
  - `status` 'matched' | 'not_matched' | 'partial_match' — Indicates the status of the request whether it was matched or not.
  - `reason` 'account_name_does_not_match' | 'account_name_maybe_match' | 'business_account_name_match' | 'personal_account_name_match' | 'business_account_name_maybe_match' | 'personal_account_name_maybe_match' | 'incorrect_account_number' | 'invalid_customer_reference' | 'account_type_not_supported' | 'opted_out_of_cop_scheme' | 'account_has_been_switched' | 'sort_code_not_supported' | 'sort_code_not_found' — A string indicating the outcome or reason for the account name match status. This will only be returned if the status is
  - `account_name` string — The name as it appears on the account.

## Other responses

- `400` — An error occurred
- `401` — An error occurred
- `500` — Internal Server error

---

[API](https://skmtc.net/acquired/apis/acquired-api.md) · [All operations](https://skmtc.net/acquired/apis/acquired-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/acquired/acquired-api/versions/7ae178a046f2/schema)