Skip to main content
POST
Verify GBP payee

Authorizations

Authorization
string
header
required

Use your OAuth client credentials to obtain a short-lived Bearer token from POST /oauth/token.

Body

application/json

This endpoint runs a UK Confirmation-of-Payee (CoP) check on a GBP bank account. You send the sort code, the account number, and the name that you expect for the account. Blaaiz returns a match or no-match result. It does not return the real account holder name. Use this endpoint to confirm payee details before you send a GBP payout. Example Use Cases:

  • Confirm that a payee name matches the account before a GBP transfer.
  • Detect a close name match and show the suggested name to the user.
  • Reduce misdirected payments and payment fraud.
sort_code
string
required

UK sort code of the account to check

Maximum string length: 20
account_number
string
required

UK account number to check

Maximum string length: 255
account_name
string
required

Name that you expect for the account

Maximum string length: 255

Response

Verification completed. The status code is 200 for a full match, a close match, and a hard no-match.

matched
boolean
required

True if the account name is a full match. False for a close match or a no-match.

match_confidence_code
enum<string> | null
required

Close-match confidence code. Blaaiz returns a code only for a close match. It returns null for a full match and for a hard no-match. PANM means a close name match on an account that is registered to an individual, not a company.

Available options:
MBAM,
ANNM,
BANM,
PANM,
null
suggested_account_name
string | null
required

Suggested account name for a close match. Blaaiz returns null for a full match and for a hard no-match.