---
title: "Create an account name check"
method: POST
path: "/account-name-check"
tags: ["Confirmation of Payee"]
---

# Create an account name check

`POST /account-name-check`

This endpoint allows you to check the account details of a payee with their bank before you create a beneficiary or payment. If the account details are confirmed, you will have greater assurance that a payment you create will reach the correct bank account.
This endpoint does not support idempotent requests. Any requests containing an x-mod-nonce header used by a previous request will return the response <code>403: Forbidden ("Unique/allowed nonce header not found")</code>

## Request body

- ConfirmationofpayeeJsonOutboundCopRequest — Details of Account Name Check Request
  - `paymentAccountId` string, required — The identifier of the account that a subsequent payment will be initiated from.
  - `sortCode` string, required — The sort code of the account.
  - `accountNumber` string, required — The account number.
  - `secondaryAccountId` string — Additional information used in conjunction with the Sort Code and Account Number to identify the account (such as a Building Society roll number).
  - `accountType` 'PERSONAL' | 'BUSINESS', required — The type of account, either a personal or business account.
  - `name` string, required — The name to match the account name against.

## Response `201`

Created

- ConfirmationofpayeeJsonOutboundCopResponse — Account Name Check Response
  - `id` string, required — Unique id for the account name check.
  - `result` ConfirmationofpayeeJsonOutboundCopResult, required — Account Name Check Result
    - `code` 'MATCHED' | 'NOT_MATCHED' | 'CLOSE_MATCH' | 'BUSINESS_ACCOUNT_NAME_MATCHED' | 'PERSONAL_ACCOUNT_NAME_MATCHED' | 'BUSINESS_ACCOUNT_CLOSE_MATCH' | 'PERSONAL_ACCOUNT_CLOSE_MATCH' | 'ACCOUNT_DOES_NOT_EXIST' | 'SECONDARY_ACCOUNT_ID_NOT_FOUND' | 'ACCOUNT_NOT_SUPPORTED' | 'ACCOUNT_SWITCHED' | 'WRONG_PARTICIPANT' | 'NO_RESPONSE' | 'NOT_ENROLLED', required — The result of the account name check.
    - `name` string — The actual name on the account (as provided by the participating organisation).

## Other responses

- `400` — Validation Errors
- `404` — Not Found
- `429` — Too Many Requests
- `500` — Internal Server Error
- `503` — Service Unavailable

---

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