# Confirm Bank Account (deprecated)

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

Endpoint: GET /bankaccounts/confirm
Version: 2
Security: apiKey

## Query parameters:

  - `internationalBankAccountIdentifier` (string)
    Uniquely identifies a bank account on a global scale, without any additional information such as bank identifier or country code. Best known system is the International Bank Account Identifier (IBAN) specified by ISO 13616:2007 and managed by SWIFT. If you use this parameter to confirm a given bank account, you do not need any additional parameter.
    Example: "CH8800781619278412000"

  - `internationalBankIdentifier` (string)
    Uniquely identifies a bank on global scale, without any additional information such as country code. Best known system is the International Bank Identifier (BIC, or SWIFT code) specified by ISO 9362 and managed by SWIFT. If you use this parameter to confirm a given bank account without an IBAN, you have to provide in addition bank account information, i.e. country code and national bank account identifier.
    Example: "KBSGCH22XXX"

  - `bankCountryCode` (string)
    To confirm national bank account information, you have to provide a country code to uniquely identify the bank account on a global scale. If you use this parameter to confirm a given bank account without an IBAN or BIC, you have to provide in addition a national bank identifier and a national bank account identifier.
    Example: "CH"

  - `nationalBankIdentifier` (string)
    Uniquely identifies a bank in a country, together with a country code parameter on a global scale. If you use this parameter to confirm a given bank account without an IBAN or BIC, you have to provide in addition a country code and a national bank account identifier.
    Example: "00781"

  - `nationalBankAccountIdentifier` (string)
    Uniquely identifies a bank account at a specific bank in a country, together with a country code parameter and a national bank identifier on a global scale. If you use this parameter to confirm a given bank account without an IBAN or BIC, you have to provide in addition a country code and a national bank identifier.
    Example: "619278412000"

## Response 200 fields (application/json):

  - `bankAccountRequest` (object)
    A bank account record holds information that universally describes a registered bank account.

  - `bankAccountRequest.internationalBankAccountIdentifier` (string)
    The IBAN of a bank account.
    Example: "CH8800781619278412000"

  - `bankAccountRequest.internationalBankIdentifier` (string)
    (BIC/SWIFT) Bank identifier which is globally unique.
    Example: "KBSGCH22XXX"

  - `bankAccountRequest.bankCountryCode` (string)
    ISO code to identify the country a bank account is registered in.
    Example: "DE"

  - `bankAccountRequest.nationalBankIdentifier` (string)
    Bank identifier which is unique in a national context, i.e. for a country.
    Example: "00781"

  - `bankAccountRequest.nationalBankAccountIdentifier` (string)
    Identifier of a bank account in a national context, i.e. for a country.
    Example: "619278412000"

  - `bankAccountConfirmed` (object)
    A bank account record holds information that universally describes a registered bank account.

  - `scoreSum` (integer)
    Sum of the scores of the individual confirmations.
    Example: "100"

  - `maxScores` (array)
    List of the maximum scores of the individual confirmations.

  - `maxScores.score` (integer)
    Trust score of the bank account.
    Example: "100"

  - `maxScores.lastUpdate` (integer)
    Last update of the trust score.
    Example: "20240302"

  - `maxScores.lastUpdateAsDate` (string)
    Last update of the trust score as date.
    Example: "2025-08-29T09:46:42Z"

  - `associatedFraudCases` (array)
    List of fraud cases associated with the bank account.

  - `associatedFraudCases.cdlId` (string)
    Unique identifier of the fraud case.
    Example: "5c6a2c7e-9b0a-4e1a-8b0a-4e1a8b0a4e1a"

  - `associatedFraudCases.version` (integer)
    Version of the fraud case.
    Example: "1"

  - `associatedFraudCases.dateOfAttack` (string)
    Date of the attack.
    Example: "2025-08-29T09:46:42Z"

  - `associatedFraudCases.type` (string)
    Fraud case type. Available options:
  * : Active warning.
  * : Announcement. 
  * : Fake document.
  * : Fake email.
  * : Fake president call.
  * : Falsified invoice.
    Example: "ACTIVE_WARNING"

  - `associatedFraudCases.description` (string)
    Description of the fraud case.
    Example: "Fraud case description"

  - `associatedFraudCases.internalComment` (string)
    Internal comment of the fraud case.
    Example: "Internal comment"

  - `associatedFraudCases.confirmationState` (string)
    Confirmation state. Available options:
  * : Confirmed.
  * : Suspected.
    Example: "CONFIRMED"

  - `associatedFraudCases.classification` (string)
    Classification of the fraud case.
    Enum: "DEMO", "TEST", "CATENAX", "STANDARD"

  - `associatedFraudCases.businessPartnerName` (string)
    The actual name.
    Example: "Corporate Data Quality AG"

  - `associatedFraudCases.businessPartnerCountryCode` (string)
    Country code (ISO 3166-1 alpha-2).
    Example: "CH"

  - `associatedFraudCases.businessPartnerLocality` (string)
    Name of the [Locality](https://meta.cdq.com/Address/locality).
    Example: "Sankt Gallen"

  - `associatedFraudCases.fraudsterEmail` (string)
    Email of the fraudster.
    Example: "thisisnot@fraud.com"

  - `associatedFraudCases.fraudsterPhone` (string)
    Phone of the fraudster.
    Example: "+49123456789"

  - `associatedFraudCases.fraudsterWebsite` (string)
    Website of the fraudster.
    Example: "www.thisisnotafraud.com"

  - `associatedFraudCases.alternativePayee` (string)
    Alternative payee of the fraud case.
    Example: "Alternative payee's name"

  - `associatedFraudCases.bankAccount` (object)
    A bank account record holds information that universally describes a registered bank account.

  - `associatedFraudCases.archived` (boolean)
    Indicates if the fraud case is archived.
    Example: "false"

  - `associatedFraudCases.alertTriggered` (boolean)
    Indicates if an alert was triggered.
    Example: "false"

  - `associatedFraudCases.createdAt` (string)
    Creation timestamp of the fraud case.
    Example: "2025-08-29T09:46:42Z"

  - `associatedFraudCases.creatorOrganization` (string)
    Creator organization of the fraud case.
    Example: "Organization name"

  - `associatedFraudCases.createdBy` (string)
    Creator user of the fraud case.
    Example: "User name"

  - `associatedFraudCases.disclosedAttributes` (array)
    Available disclosed attributes:
  * : Bank account bank country code.
  * : Bank account bank name.
  * : Bank account international bank identifier.
  * : Bank account international bank account identifier.
  * : Bank account national bank identifier.
  * : Bank account national bank account identifier.
  * : Fraud case CDL ID.
  * : Fraud case alternative payee.
  * : Fraud case business partner name.
  * : Fraud case business partner country code.
  * : Fraud case business partner locality.
  * : Fraud case date of attack.
  * : Fraud case creation timestamp.
  * : Fraud case description.
  * : Fraud case internal comment.
  * : Fraud case fraudster email.
  * : Fraud case fraudster phone.
  * : Fraud case fraudster website.
  * : Fraud case type.
  * : Fraud case confirmation state.
  * : Fraud case creator organization.
  * : Fraud case creator user.
  * : Fraud case disclosed attributes bank account bank name.
  * : Fraud case disclosed attributes bank account bank country code.
  * : Fraud case disclosed attributes bank account international bank identifier.
  * : Fraud case disclosed attributes bank account international bank account identifier.
  * : Fraud case disclosed attributes bank account national bank identifier.
  * : Fraud case disclosed attributes bank account national bank account identifier.
  * : Fraud case disclosed attributes fraud case alternative payee.
  * : Fraud case disclosed attributes fraud case business partner name.
  * : Fraud case disclosed attributes fraud case business partner country code.
  * : Fraud case disclosed attributes fraud case business partner locality.
  * : Fraud case disclosed attributes fraud case date of attack.
  * : Fraud case disclosed attributes fraud case creation timestamp.
  * : Fraud case disclosed attributes fraud case description.
  * : Fraud case disclosed attributes fraud case fraudster email.
  * : Fraud case disclosed attributes fraud case fraudster phone.
  * : Fraud case disclosed attributes fraud case fraudster website.
  * : Fraud case disclosed attributes fraud case type.
  * : Fraud case disclosed attributes fraud case confirmation state.
  * : Fraud case disclosed attributes fraud case creator organization.
  * : Fraud case disclosed attributes fraud case creator user.
    Enum: "BANKACCOUNT_BANK_COUNTRY_CODE", "BANKACCOUNT_BANK_NAME", "BANKACCOUNT_INTERNATIONAL_BANK_IDENTIFIER", "BANKACCOUNT_INTERNATIONAL_BANK_ACCOUNT_IDENTIFIER", "BANKACCOUNT_NATIONAL_BANK_IDENTIFIER", "BANKACCOUNT_NATIONAL_BANK_ACCOUNT_IDENTIFIER", "FRAUDCASE_CDL_ID", "FRAUDCASE_ALTERNATIVE_PAYEE", "FRAUDCASE_BUSINESS_PARTNER_NAME", "FRAUDCASE_BUSINESS_PARTNER_COUNTRY_CODE", "FRAUDCASE_BUSINESS_PARTNER_LOCALITY", "FRAUDCASE_DATE_OF_ATTACK", "FRAUDCASE_CREATION_TIMESTAMP", "FRAUDCASE_DESCRIPTION", "FRAUDCASE_INTERNAL_COMMENT", "FRAUDCASE_FRAUDSTER_EMAIL", "FRAUDCASE_FRAUDSTER_PHONE", "FRAUDCASE_FRAUDSTER_WEBSITE", "FRAUDCASE_TYPE", "FRAUDCASE_CONFIRMATION_STATE", "FRAUDCASE_CREATOR_ORGANIZATION", "FRAUDCASE_CREATOR_USER", "FRAUDCASE_DISCLOSED_ATTRIBUTES_BANKACCOUNT_BANK_NAME", "FRAUDCASE_DISCLOSED_ATTRIBUTES_BANKACCOUNT_BANK_COUNTRY_CODE", "FRAUDCASE_DISCLOSED_ATTRIBUTES_BANKACCOUNT_INTERNATIONAL_BANK_IDENTIFIER", "FRAUDCASE_DISCLOSED_ATTRIBUTES_BANKACCOUNT_INTERNATIONAL_BANK_ACCOUNT_IDENTIFIER", "FRAUDCASE_DISCLOSED_ATTRIBUTES_BANKACCOUNT_NATIONAL_BANK_IDENTIFIER", "FRAUDCASE_DISCLOSED_ATTRIBUTES_BANKACCOUNT_NATIONAL_BANK_ACCOUNT_IDENTIFIER", "FRAUDCASE_DISCLOSED_ATTRIBUTES_FRAUDCASE_ALTERNATIVE_PAYEE", "FRAUDCASE_DISCLOSED_ATTRIBUTES_FRAUDCASE_BUSINESS_PARTNER_NAME", "FRAUDCASE_DISCLOSED_ATTRIBUTES_FRAUDCASE_BUSINESS_PARTNER_COUNTRY_CODE", "FRAUDCASE_DISCLOSED_ATTRIBUTES_FRAUDCASE_BUSINESS_PARTNER_LOCALITY", "FRAUDCASE_DISCLOSED_ATTRIBUTES_FRAUDCASE_DATE_OF_ATTACK", "FRAUDCASE_DISCLOSED_ATTRIBUTES_FRAUDCASE_CREATION_TIMESTAMP", "FRAUDCASE_DISCLOSED_ATTRIBUTES_FRAUDCASE_DESCRIPTION", "FRAUDCASE_DISCLOSED_ATTRIBUTES_FRAUDCASE_FRAUDSTER_EMAIL", "FRAUDCASE_DISCLOSED_ATTRIBUTES_FRAUDCASE_FRAUDSTER_PHONE", "FRAUDCASE_DISCLOSED_ATTRIBUTES_FRAUDCASE_FRAUDSTER_WEBSITE", "FRAUDCASE_DISCLOSED_ATTRIBUTES_FRAUDCASE_TYPE", "FRAUDCASE_DISCLOSED_ATTRIBUTES_FRAUDCASE_CONFIRMATION_STATE", "FRAUDCASE_DISCLOSED_ATTRIBUTES_FRAUDCASE_CREATOR_ORGANIZATION", "FRAUDCASE_DISCLOSED_ATTRIBUTES_FRAUDCASE_CREATOR_USER"

  - `associatedFraudCases.relatedFraudCases` (integer)
    Number of related fraud cases.
    Example: "5"

## Response 400 fields (application/json):

  - `id` (string)
    Unique identifier of the error.
    Example: "5c6a2c7e-9b0a-4e1a-8b0a-4e1a8b0a4e1a"

  - `path` (string)
    Requested path which caused this error.
    Example: "/v2/businesspartners/lookup"

  - `timestamp` (string)
    ISO 8601 representation of the timestamp.
    Example: "2025-08-29T09:46:42Z"

  - `message` (string)
    Details about the error.
    Example: "This user is not allowed to access this service."

  - `error` (string)
    RFC 7231 error which belongs to the status code.
    Example: "BAD_REQUEST"

  - `status` (integer)
    RFC 7231 status code for this error.
    Example: "400"

## Response 401 fields (application/json):

  - `id` (string)
    Unique identifier of the error.
    Example: "5c6a2c7e-9b0a-4e1a-8b0a-4e1a8b0a4e1a"

  - `path` (string)
    Requested path which caused this error.
    Example: "/v2/businesspartners/lookup"

  - `timestamp` (string)
    ISO 8601 representation of the timestamp.
    Example: "2025-08-29T09:46:42Z"

  - `message` (string)
    Details about the error.
    Example: "This user is not allowed to access this service."

  - `error` (string)
    RFC 7231 error which belongs to the status code.
    Example: "BAD_REQUEST"

  - `status` (integer)
    RFC 7231 status code for this error.
    Example: "400"

## Response 403 fields (application/json):

  - `id` (string)
    Unique identifier of the error.
    Example: "5c6a2c7e-9b0a-4e1a-8b0a-4e1a8b0a4e1a"

  - `path` (string)
    Requested path which caused this error.
    Example: "/v2/businesspartners/lookup"

  - `timestamp` (string)
    ISO 8601 representation of the timestamp.
    Example: "2025-08-29T09:46:42Z"

  - `message` (string)
    Details about the error.
    Example: "This user is not allowed to access this service."

  - `error` (string)
    RFC 7231 error which belongs to the status code.
    Example: "BAD_REQUEST"

  - `status` (integer)
    RFC 7231 status code for this error.
    Example: "400"

## Response 404 fields (application/json):

  - `id` (string)
    Unique identifier of the error.
    Example: "5c6a2c7e-9b0a-4e1a-8b0a-4e1a8b0a4e1a"

  - `path` (string)
    Requested path which caused this error.
    Example: "/v2/businesspartners/lookup"

  - `timestamp` (string)
    ISO 8601 representation of the timestamp.
    Example: "2025-08-29T09:46:42Z"

  - `message` (string)
    Details about the error.
    Example: "This user is not allowed to access this service."

  - `error` (string)
    RFC 7231 error which belongs to the status code.
    Example: "BAD_REQUEST"

  - `status` (integer)
    RFC 7231 status code for this error.
    Example: "400"

## Response 406 fields (application/json):

  - `id` (string)
    Unique identifier of the error.
    Example: "5c6a2c7e-9b0a-4e1a-8b0a-4e1a8b0a4e1a"

  - `path` (string)
    Requested path which caused this error.
    Example: "/v2/businesspartners/lookup"

  - `timestamp` (string)
    ISO 8601 representation of the timestamp.
    Example: "2025-08-29T09:46:42Z"

  - `message` (string)
    Details about the error.
    Example: "This user is not allowed to access this service."

  - `error` (string)
    RFC 7231 error which belongs to the status code.
    Example: "BAD_REQUEST"

  - `status` (integer)
    RFC 7231 status code for this error.
    Example: "400"

## Response 503 fields (application/json):

  - `id` (string)
    Unique identifier of the error.
    Example: "5c6a2c7e-9b0a-4e1a-8b0a-4e1a8b0a4e1a"

  - `path` (string)
    Requested path which caused this error.
    Example: "/v2/businesspartners/lookup"

  - `timestamp` (string)
    ISO 8601 representation of the timestamp.
    Example: "2025-08-29T09:46:42Z"

  - `message` (string)
    Details about the error.
    Example: "This user is not allowed to access this service."

  - `error` (string)
    RFC 7231 error which belongs to the status code.
    Example: "BAD_REQUEST"

  - `status` (integer)
    RFC 7231 status code for this error.
    Example: "400"