Verify if IBAN holder name or legal entity ID matches

Headers

Idempotency-Key

string

required

Idempotency key to prevent duplicate requests

Body

application/json

Payload containing:iban (string, mandatory); one of account_holder_name (string) OR organisation_identification (object); additional_attribute (string, optional)

iban

string

required

IBAN to verify

Minimum string length: 1

account_holder_name

string

Account holder name (natural person or legal entity) of the associated IBAN.

additional_attribute

string

Additional free-text metadata (e.g. payment context, internal ref)

organisation_identification

object

Legal-entity identifiers for the IBAN owner. Either lei, bic or other must be provided.

Show child attributes

responding_psp_bic

string

11 character ISO code assigned by SWIFT and used to identify a financial institution in financial transactions.

Response

Verification result

match_result

enum<string>

required

Result of the VoP check: one of MATCH, CLOSE_MATCH, NO_MATCH, CANNOT_VERIFY

Available options:

MATCH,

CLOSE_MATCH,

NO_MATCH,

CANNOT_VERIFY

Example:

"CLOSE_MATCH"

reference_id

string

required

Unique ID associated with the VoP request (traceable for audit)

Example:

"123e4567-e89b-12d3-a456-426614174000"

timestamp

string<date-time>

required

ISO 8601 datetime of when the check was processed

Example:

"2025-04-29T15:30:00Z"

real_name

string

Present if matchResult == CLOSE_MATCH; the best-matched account holder name

Example:

"Alice Johnson"

Getting Started

Account Management

Verification

Verify if IBAN holder name or legal entity ID matches

Headers

Body

Response