# Trigger a bank account validation.

Trigger a bank account validation.

Endpoint: POST /stored-data/v1/consents/{consentId}/account-verification
Version: all
Security: Bearer

## Security:

  - `Bearer` (unknown)
    http bearer scopes: api:stored_data

## Path parameters:

  - `consentId` (string, required)

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

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

  - `identifier` (object, required)

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

  - `identifier.bic` (string)
    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)
    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)
    The bank's unique identifier for the account

  - `identifier.countryCode` (string)
    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:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

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

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

  - `matchedAccount` (object)

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

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

  - `matchedAccount.bankCode` (string)
    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)
    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)
    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)
    Account holder name returned by the provider that is used for matching with provided account details

## Response 400:

  - `400` (unknown)
    Bad Request

## Response 400 fields (application/json):

  - `code` (string)
    Error code.

  - `description` (string)
    Error message.

  - `details` (string)
    Error details.

  - `correlationId` (string)
    User transaction tracking Id

## Response 403:

  - `403` (unknown)
    Forbidden

## Response 403 fields (application/json):

  - `code` (string)
    Error code.

  - `description` (string)
    Error message.

  - `details` (string)
    Error details.

  - `correlationId` (string)
    User transaction tracking Id

## Response 404:

  - `404` (unknown)
    Not Found

## Response 404 fields (application/json):

  - `code` (string)
    Error code.

  - `description` (string)
    Error message.

  - `details` (string)
    Error details.

  - `correlationId` (string)
    User transaction tracking Id

## Response 500:

  - `500` (unknown)
    Internal Server Error

## Response 500 fields (application/json):

  - `code` (string)
    Error code.

  - `description` (string)
    Error message.

  - `details` (string)
    Error details.

  - `correlationId` (string)
    User transaction tracking Id

## Response 502:

  - `502` (unknown)
    Bad Gateway

## Response 502 fields (application/json):

  - `code` (string)
    Error code.

  - `description` (string)
    Error message.

  - `details` (string)
    Error details.

  - `correlationId` (string)
    User transaction tracking Id