# Bank Account Verification

Gather endpoints that provide functionalities for verifying bank account data. These functionalities include 
confirming the reliability of given bank account data by CDL Trust Scores provided by other companies for the 
given bank account, curating the given bank account, and uploading bank accounts for batch confirmation.


## Confirm Reliability

 - [POST /v2/bankaccounts/confirm](https://developer.cdq.com/apis/bankaccount-data-api/api-v2/bank-account-verification/paths/~1v2~1bankaccounts~1confirm/post.md): Confirm the reliability of the given bank account against the CDQ Whitelist (trust score based on transactions)
and the Blacklist (fraud cases).

The BankAccount that is sent in the request needs to uniquely identify a bank account. Minimal sets of attributes
that are considered valid to identify a bank account are:
  1. Only the IBAN (= internationalBankAccountIdentifier):
      
  2. The bank account number (= nationalBankAccountIdentifier) and the BIC (= internationalBankIdentifier):
      
  3. The bank account number (= nationalBankAccountIdentifier), bank code/number (= nationalBankIdentifier) and bank country code (= bankCountryCode):
      
If attributes are missing to uniquely identify a bank account an ApiError will be returned.

The response will always contain the BankAccount provided in the request and depending on the result found in the Whitelist
or the Blacklist or neither, the following:
1. A whitelist entry and no fraud case was found:
      
2. A fraud case entry was found:
      
3. The bank account is unknown (no trust score and no fraud case exists):
      


## Curate Bank Account

 - [POST /bankaccounts/curate](https://developer.cdq.com/apis/bankaccount-data-api/api-v2/bank-account-verification/paths/~1bankaccounts~1curate/post.md): Curates the given bank account.

The BankAccount that is sent in the request has to be uniquely identifiable.
Minimal sets of attributes that identify a BankAccount are:
  1. Only the IBAN (= internationalBankAccountIdentifier):
      
  2. The bank account number (= nationalBankAccountIdentifier), bank code/number (= bank.nationalBankIdentifier) and bank country code (= bank.address.country.shortName):
      
  3. The bank account number (= nationalBankAccountIdentifier), bank code/number (= bank.nationalBankIdentifier) and the BIC (= internationalBankIdentifier):
      

If IBAN is not present in the request it will be generated only if there is sufficient data:
- countryCode
- internationalBankIdentifier
- nationalBankAccountIdentifier

Or

- internationalBankIdentifier
- nationalBankIdentifier
- nationalBankAccountIdentifier

For the following countries the generation of the internationalBankAccountIdentifier (IBAN)
is NOT supported in the current version:

AL, BA, BE, BG, BI, BR, DJ, EE, EG, ES, FI, FO, FR, HU, IS, IT, LY, MC, ME, MK,
MR, NO, PL, PT, RS, SC, SD, SI, SM, TL, TR

The response will always contain the original BankAccount provided in the request and a curated version of it. For example:
      

If the given request does not provide one of the combinations of attributes described above, an ApiError will be returned:
      
Message contains concatenated descriptions of all errors that occurred in the request.


## Upload Bank Accounts

 - [POST /bankaccounts](https://developer.cdq.com/apis/bankaccount-data-api/api-v2/bank-account-verification/paths/~1bankaccounts/post.md): Upload a CSV file with bank account data to be analyzed by several jobs.

## Start Batch Confirmation

 - [POST /bankaccounts/jobs/confirmation](https://developer.cdq.com/apis/bankaccount-data-api/api-v2/bank-account-verification/paths/~1bankaccounts~1jobs~1confirmation/post.md): -> Start a job to confirm all bank accounts provided by a previously uploaded CSV file, identified by the storage ID in the request object or from bank accounts of business partners in given business partner storage.

## Poll Batch Confirmation Status

 - [GET /bankaccounts/jobs](https://developer.cdq.com/apis/bankaccount-data-api/api-v2/bank-account-verification/paths/~1bankaccounts~1jobs/get.md): Get the status (including progress, if running) of a given job.

## List Bank Account Statistics

 - [GET /bankaccounts/statistics](https://developer.cdq.com/apis/bankaccount-data-api/api-v2/bank-account-verification/paths/~1bankaccounts~1statistics/get.md): -> Calculates statistics from a bank account database and provides information about whitelist records, whitelist bank accounts, country distribution, etc.

## Confirm Bank Account (deprecated)

 - [GET /bankaccounts/confirm](https://developer.cdq.com/apis/bankaccount-data-api/api-v2/bank-account-verification/paths/~1bankaccounts~1confirm/get.md): -> Confirm reliability of given bank account data by CDL Trust Scores provided by other companies for the given bank account.