Bank Account Verification

-> Confirm reliability of given bank account data by CDL Trust Scores provided by other companies for the given bank account.

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):

   {
     "bankAccount": {
       "internationalBankAccountIdentifier": "CH8800781619278412000"
     }
   }
   

2. The bank account number (= nationalBankAccountIdentifier), bank code/number (= bank.nationalBankIdentifier) and bank country code (= bank.address.country.shortName):

   {
     "bankAccount": {
       "nationalBankAccountIdentifier": "619278412000",
       "bank" : {
         "nationalBankIdentifier": "00781",
         "address": {
           "country": {
             "shortName": "CH"
           }
         }
       }
     }
   }
   

3. The bank account number (= nationalBankAccountIdentifier), bank code/number (= bank.nationalBankIdentifier) and the BIC (= internationalBankIdentifier):

   {
     "bankAccount": {
       "nationalBankAccountIdentifier": "619278412000",
       "bank" : {
         "nationalBankIdentifier": "00781",
         "internationalBankIdentifier": "KBSGCH22XXX"
       }
     }
   }
   

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: { "originalBankAccount": { "internationalBankAccountIdentifier": "CH8800781619278412000" }, "curatedBankAccount": { "internationalBankAccountIdentifier": "CH8800781619278412000" "nationalBankAccountIdentifier": "619278412000", "bank" : { "nationalBankIdentifier": "00781", "address": { "country": { "shortName": "CH" } } } } }

If the given request does not provide one of the combinations of attributes described above, an ApiError will be returned: { "timestamp": "...", "message": "...", "error": "Bad Request", "path": "...", "status": 400 } Message contains concatenated descriptions of all errors that occurred in the request.

-> Calculates statistics from a bank account database and provides information about whitelist records, whitelist bank accounts, country distribution, etc.

Get the status (including progress, if running) of a given job.

-> 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.

Upload a CSV file with bank account data to be analyzed by several jobs.