# Trigger a bank account validation.

Returns a result with an accompanying error code if validation is inconclusive.

Endpoint: POST /account-verification/v3/consents/{consentId}
Version: all
Security: Bearer

## Path parameters:

  - `consentId` (string, required)
    The consent ID to fetch the account information for

## Request fields (application/json-patch+json):

  - `accountHolderName` (string, required)
    Individual associated with the target account

  - `identifier` (object, required)

  - `identifier.iban` (string,null)
    International Bank Account Number (IBAN)

  - `identifier.bic` (string,null)
    Bank Identifier Code (BIC) is the SWIFT Address assigned to a bank in order to send
automated payments quickly and accurately to the banks concerned.

  - `identifier.bankCode` (string,null)
    The national bank transit or transfer code used for identification of the bank assigned
by a central bank in a country, eg: A Routing number(US/CA) or Sort code(UK)

  - `identifier.accountNumber` (string,null)
    The bank's unique identifier for the account

  - `identifier.countryCode` (string,null)
    An ISO 3166-1 alpha-2 Country code for the account.

  - `ignoreMiddleNames` (boolean)
    Flag to indicate if matching with middle names is enabled

## Response 200 fields (application/json):

  - `result` (string)
    Enum: "Pass", "Fail", "NA", "Partial"

  - `reason` (string)
    Enum: "AccountIdentifierNotFound", "PartyNameNotFound", "NameOnlyMatch"

  - `matchedAccount` (object)

  - `matchedAccount.countryCode` (string,null)
    An ISO 3166-1 alpha-2 Country code for the account.

  - `matchedAccount.accountNumber` (string,null)
    The bank's unique identifier for the account

  - `matchedAccount.bankCode` (string,null)
    The national bank transit or transfer code used for identification of the bank assigned
by a central bank in a country, eg: A Routing number(US/CA) or Sort code(UK)

  - `matchedAccount.iban` (string,null)
    An internationally agreed upon system of identifying bank accounts across national borders
to facilitate the communication and processing of cross border transactions with a reduced 
risk of transcription errors.

  - `matchedAccount.bic` (string,null)
    BIC (Business Identifier Code) is an ISO 9362 standard for routing business transactions
and identifying business parties.

  - `matchedAccount.type` (string)
    Enum: "Iban", "Bic", "CountrySpecific"

  - `matchedAccountHolderName` (string,null)
    Account holder name returned by the provider that is used for matching with provided account details

## Response 400 fields (application/json):

  - `code` (string,null)
    Error code.

  - `description` (string,null)
    Error message.

  - `details` (string,null)
    Error details.

  - `correlationId` (string,null)
    User transaction tracking Id

## Response 403 fields (application/json):

  - `code` (string,null)
    Error code.

  - `description` (string,null)
    Error message.

  - `details` (string,null)
    Error details.

  - `correlationId` (string,null)
    User transaction tracking Id

## Response 404 fields (application/json):

  - `code` (string,null)
    Error code.

  - `description` (string,null)
    Error message.

  - `details` (string,null)
    Error details.

  - `correlationId` (string,null)
    User transaction tracking Id

## Response 500 fields (application/json):

  - `code` (string,null)
    Error code.

  - `description` (string,null)
    Error message.

  - `details` (string,null)
    Error details.

  - `correlationId` (string,null)
    User transaction tracking Id

## Response 502 fields (application/json):

  - `code` (string,null)
    Error code.

  - `description` (string,null)
    Error message.

  - `details` (string,null)
    Error details.

  - `correlationId` (string,null)
    User transaction tracking Id