# Upsert Bank Data

Upsert system bank data with the given parameters.

Endpoint: POST /system/banks/upsert
Version: 2
Security: apiKey

## Request fields (application/json):

  - `dataTransformationDefinitionId` (string)
    Unique identifier for a data transformation definition.
    Example: "SAP.ODM"

  - `banks` (array)
    List of banks to be upserted.

  - `banks.names` (array)
    Name of a bank.
    Example: "Swiss National Bank"

  - `banks.names.shortName` (string)
    Abbreviated name of a bank.
    Example: "SNB"

  - `banks.names.type` (object)
    Type of the Bank Name.

  - `banks.names.type.url` (string)
    URL to the documentation which summarizes all details of the Bank Name Type.
    Example: "https://meta.cdq.com/Bank_account/bank/name/type"

  - `banks.names.type.name` (string)
    Name of the Bank Name Type.
    Example: "Bank name acronym"

  - `banks.names.type.technicalKey` (string)
    Technical key of the Bank Name Type.
    Example: "BANK_NAME_TYPE_ACRONYM"

  - `banks.names.value` (string)
    Value of the Bank Name.
    Example: "Swiss National Bank"

  - `banks.names.version` (object)
    Specifies the version of a bank name in terms of language and charset.

  - `banks.names.version.charset` (object)
    Character set.

  - `banks.names.version.charset.name` (string)
    Name of character set. Supported character sets can be found [here](https://meta.cdq.com/Address/version/character_set).
    Example: "International"

  - `banks.names.version.charset.technicalKey` (string)
    Technical key of character set. Supported character sets can be found [here](https://meta.cdq.com/Address/version/character_set).
    Example: "INTERNATIONAL"

  - `banks.names.version.language` (object)
    Naming of a language according to ISO 639-1.

  - `banks.names.version.language.name` (string)
    ISO 639-1 name of language.
    Example: "German"

  - `banks.names.version.language.technicalKey` (string)
    ISO 639-1 two-letter code of languages.
    Example: "DE"

  - `banks.contact` (object)
    Bank contact information.

  - `banks.contact.emails` (array)

  - `banks.contact.emails.address` (string)
    An actual email address of the bank.
    Example: "info@cdq.com"

  - `banks.contact.emails.type` (object)
    A type of a email address of the bank.

  - `banks.contact.emails.type.name` (string)
    Name of the Bank Contact Email Type.
    Example: "Bank contact email"

  - `banks.contact.emails.type.url` (string)
    URL to the documentation which summarizes all details of the Bank Contact Email Type.
    Example: "https://meta.cdq.com/Bank_account/bank/contact/contact_email/type"

  - `banks.contact.emails.type.technicalKey` (string)
    Technical key of the Bank Contact Email Type.
    Example: "BANK_CONTACT_EMAIL_TYPE"

  - `banks.contact.phoneNumbers` (array)

  - `banks.contact.phoneNumbers.countryPrefix` (string)
    A country prefix of a bank phone number.
    Example: "0041"

  - `banks.contact.phoneNumbers.number` (string)
    A complete phone number of the bank without any country prefixes.
    Example: "58 631 00 00"

  - `banks.contact.phoneNumbers.type` (object)
    A type of the bank phone number.

  - `banks.contact.phoneNumbers.type.name` (string)
    Name of the Bank Contact Phone Number Type.
    Example: "Bank contact phone number"

  - `banks.contact.phoneNumbers.type.url` (string)
    URL to the documentation which summarizes all details of the Bank Contact Phone Number Type.
    Example: "https://meta.cdq.com/Bank_account/bank/contact/phone_number/type"

  - `banks.contact.phoneNumbers.type.technicalKey` (string)
    Technical key of the Bank Contact Phone Number Type.
    Example: "BANK_CONTACT_PHONE_TYPE_PHONE"

  - `banks.contact.phoneNumbers.value` (string)
    The actual complete bank phone number incl. country prefix.
    Example: "0041 58 631 00 00"

  - `banks.contact.websites` (array)

  - `banks.contact.websites.url` (string)
    The actual URL of the bank's website.
    Example: "https://cdq.com"

  - `banks.contact.websites.type` (object)
    A type of the bank's website.

  - `banks.contact.websites.type.name` (string)
    Name of the Bank Contact Website Type.
    Example: "Bank contact website"

  - `banks.contact.websites.type.url` (string)
    URL to the documentation which summarizes all details of the Bank Contact Website Type.
    Example: "https://meta.cdq.com/Bank_account/bank/contact/website/type"

  - `banks.contact.websites.type.technicalKey` (string)
    Technical key of the Bank Contact Website Type.
    Example: "BANK_CONTACT_WEBSITE_TYPE"

  - `banks.identifiers` (array)

  - `banks.identifiers.type` (object)
    Type of the Bank Identifier.

  - `banks.identifiers.type.url` (string)
    URL to the documentation which summarizes all details of the Bank Identifier Type.
    Example: "https://meta.cdq.com/Bank_account/bank/identifier/type"

  - `banks.identifiers.type.name` (string)
    Name of the Bank Identifier Type.
    Example: "Bank SWIFT Code"

  - `banks.identifiers.type.technicalKey` (string)
    Technical Key of the Bank Identifier Type.
    Example: "WR_BSC"

  - `banks.identifiers.value` (string)
    The actual value of the bank identifier.
    Example: "CH1234567890123456789"

  - `banks.identifiers.issuingBody` (object)
    An Issuing Body is an organization or government institution that is responsible for assigning unique identifiers to individuals, organizations, or objects.

  - `banks.identifiers.issuingBody.name` (string)
    Name of the Bank Issuing Body.
    Example: "Bank Identifier Code"

  - `banks.identifiers.issuingBody.url` (string)
    URL to the documentation which summarizes all details of the Bank Issuing Body.
    Example: "https://meta.cdq.com/Bank_account/bank/identifier/issuing_body"

  - `banks.identifiers.issuingBody.technicalKey` (string)
    Technical Key of the Bank Issuing Body.
    Example: "BIC"

  - `banks.identifiers.status` (object)
    Status of the identifier.

  - `banks.identifiers.status.name` (string)
    Name of the Identifier Status.
    Example: "Active"

  - `banks.identifiers.status.technicalKey` (string)
    Technical key of the Identifier Status.
    Example: "ACTIVE"

  - `banks.addresses` (array)
    List of addresses.

  - `banks.addresses.version` (object)
    CDQ supports multiple versions of addresses comprising different charsets and languages. An address version is a unique combination of a character set and a language.

  - `banks.addresses.version.characterSet` (object)
    Character set.

  - `banks.addresses.identifyingName` (object)
    An identifying name assigned to an address. In most cases the identifying name refers to the name of a registered agent.

  - `banks.addresses.identifyingName.value` (string)
    An identifying name assigned to an address. In most cases the identifying name refers to the name of a registered agent.
    Example: "John Doe"

  - `banks.addresses.externalId` (string)
    ID the address has in the external system where the record originates from.
    Example: "1"

  - `banks.addresses.metadata` (object)
    Specifies the language and primary data provenance.

  - `banks.addresses.metadata.primaryProvenance` (object)
    The source of the change or update. Could be the reference data source as VIES or Organization.

  - `banks.addresses.metadata.primaryProvenance.name` (string)
    Display Name of the Provenance Name.
    Example: "VIES"

  - `banks.addresses.metadata.primaryProvenance.url` (string)
    URL to the documentation which summarizes all details of the Provenance Name.
    Example: "https://meta.cdq.com/index.php?title=Property:Has_prefix&limit=500&offset=0&from=&until=&filter="

  - `banks.addresses.metadata.primaryProvenance.technicalKey` (string)
    Technical Key of the Provenance Name.
    Example: "VIES"

  - `banks.addresses.metadata.primaryProvenance.cdqId` (string)
    The ID provided for a linkage with the source by CDQ.
    Example: "VIES:PL8660001429"

  - `banks.addresses.careOf` (object)
    Signifies an intermediary who is responsible for transferring a piece of mail between the postal system and the final addressee. For example, when the addressee has no standard address, is under a corporate mail system, or is being manually forwarded mail sent to a more accessible location.

  - `banks.addresses.careOf.value` (string)
    Value of the CareOf.
    Example: "CDQ GmbH c/o Product Department"

  - `banks.addresses.contexts` (array)

  - `banks.addresses.contexts.value` (string)
    Value of the Address Context.
    Example: "Production hall 7, Storage field 8."

  - `banks.addresses.country` (object)
    Country consisting of the country name and country code (ISO 3166-1 alpha-2).

  - `banks.addresses.country.shortName` (string)
    Country code (ISO 3166-1 alpha-2).
    Example: "CH"

  - `banks.addresses.country.value` (string)
    Country name (ISO 3166-1 alpha-2).
    Example: "Switzerland"

  - `banks.addresses.administrativeAreas` (array)

  - `banks.addresses.administrativeAreas.value` (string)
    Name of the [Administrative Area](https://meta.cdq.com/Address/administrative_area).
    Example: "Sankt Gallen"

  - `banks.addresses.administrativeAreas.shortName` (string)
    Abbreviation for the [Administrative Area](https://meta.cdq.com/Address/administrative_area).
    Example: "SG"

  - `banks.addresses.administrativeAreas.fipsCode` (string)
    FIPS codes are numbers which uniquely identify geographic areas. The number of digits in FIPS codes vary depending on the level of geography. State-level FIPS codes have two digits, county-level FIPS codes have five digits of which the first two are the FIPS code of the state to which the county belongs.
    Example: "SZ15"

  - `banks.addresses.administrativeAreas.isoCode` (string)
    ISO 3166-2 code which uniquely defines the names of countries and their subdivisions (e.g., provinces or states).
    Example: "CH-SG"

  - `banks.addresses.administrativeAreas.type` (object)
    Type of the [Administrative Area](https://meta.cdq.com/Address/administrative_area).

  - `banks.addresses.administrativeAreas.type.name` (any)

  - `banks.addresses.administrativeAreas.type.url` (any)

  - `banks.addresses.administrativeAreas.type.technicalKey` (any)

  - `banks.addresses.postCodes` (array)
    Example: ["9000"]

  - `banks.addresses.postCodes.value` (string)
    Effective [post code](https://meta.cdq.com/Address/post_code).
    Example: "9000"

  - `banks.addresses.postCodes.type` (object)
    Type of the Post Code.

  - `banks.addresses.localities` (array)

  - `banks.addresses.localities.type` (object)
    Type of the [Locality](https://meta.cdq.com/Address/locality).

  - `banks.addresses.localities.shortName` (string)
    Abbreviation of the [Locality](https://meta.cdq.com/Address/locality).
    Example: "St. Gallen"

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

  - `banks.addresses.thoroughfares` (array)

  - `banks.addresses.thoroughfares.type` (object)
    Type of the [Thoroughfare](https://meta.cdq.com/Address/thoroughfare).

  - `banks.addresses.thoroughfares.shortName` (string)
    Abbreviation of the [Thoroughfare](https://meta.cdq.com/Address/thoroughfare).
    Example: "Lukasstr. 4"

  - `banks.addresses.thoroughfares.number` (string)
    Number of the [Thoroughfare](https://meta.cdq.com/Address/thoroughfare).
    Example: "4"

  - `banks.addresses.thoroughfares.value` (string)
    Comprehensive designation of the [Thoroughfare](https://meta.cdq.com/Address/thoroughfare) including the thoroughfare type such as Street, or Rue.
    Example: "Lukasstraße 4"

  - `banks.addresses.thoroughfares.name` (string)
    Pure name of the [Thoroughfare](https://meta.cdq.com/Address/thoroughfare) not comprising the thoroughfare type such as Street, or Rue.
    Example: "Lukasstraße"

  - `banks.addresses.thoroughfares.direction` (string)
    Direction of the [Thoroughfare](https://meta.cdq.com/Address/thoroughfare).
    Example: "221-bis Baker Street, North"

  - `banks.addresses.premises` (array)

  - `banks.addresses.premises.value` (string)
    The actual value of a Premise in the language of the address.
    Example: "Lukasstraße 4"

  - `banks.addresses.premises.shortName` (string)
    Abbreviation of the Premise.
    Example: "Lukasstr. 4"

  - `banks.addresses.premises.number` (string)
    Number of the Premise.
    Example: "4"

  - `banks.addresses.premises.type` (object)
    Type of the Premise.

  - `banks.addresses.postalDeliveryPoints` (array)

  - `banks.addresses.postalDeliveryPoints.type` (object)
    A single mailbox or other place at which postal mail is delivered.

  - `banks.addresses.postalDeliveryPoints.shortName` (string)
    Stort name of the [Postal Delivery Point](https://meta.cdq.com/Address/postal_delivery_point).
    Example: "St Gallen, Postfach 460"

  - `banks.addresses.postalDeliveryPoints.number` (string)
    Number of the [Postal Delivery Point](https://meta.cdq.com/Address/postal_delivery_point).
    Example: "460"

  - `banks.addresses.postalDeliveryPoints.value` (string)
    Value of the [Postal Delivery Point](https://meta.cdq.com/Address/postal_delivery_point).
    Example: "Postfach"

  - `banks.addresses.openingHours` (array)

  - `banks.addresses.openingHours.openingHour` (string)
    Company openning hour.
    Example: "09:00 AM"

  - `banks.addresses.openingHours.closingHour` (string)
    Company closing hour.
    Example: "05:00 PM"

  - `banks.addresses.openingHours.weekday` (string)
    A day in the week in which the company is open.
    Example: "Monday"

  - `banks.addresses.geographicCoordinates` (object)
    Decimal geographic coordinates (WGS 84 - reference coordinate system).

  - `banks.addresses.geographicCoordinates.latitude` (number)
    Plain on the earth's surface north or south of the equator.
    Example: "47.439549"

  - `banks.addresses.geographicCoordinates.longitude` (number)
    Plain on the earth's surface east or west of a meridian.
    Example: "9.395275"

  - `banks.addresses.types` (array)

  - `banks.addresses.types.name` (string)
    Display label for the Address Type.
    Example: "Legal Address"

  - `banks.addresses.types.url` (string)
    URL to the documentation which summarizes all details of the [Address Type](https://meta.cdq.com/Address/type).
    Example: "https://meta.cdq.com/Address/type"

  - `banks.addresses.types.technicalKey` (string)
    Technical key of the Address Type.
    Example: "LEGAL_ADDRESS"

  - `banks.addresses.formattedAddress` (object)
    A formatted address is a structured address of VIES data source.

  - `banks.addresses.formattedAddress.country` (string)
    Country name.
    Example: "Switzerland"

  - `banks.addresses.formattedAddress.administrativeArea` (string)
    A top-level geographical or political area division in a country.
    Example: "Sankt Gallen"

  - `banks.addresses.formattedAddress.region` (string)
    Top level subdivision of a country.
    Example: "Sankt Gallen"

  - `banks.addresses.formattedAddress.regionCode` (string)
    A country specific code for a certain address in the region.
    Example: "9004"

  - `banks.addresses.formattedAddress.locality` (string)
    A locality is a named densely populated area (a place) such as town, village, suburb, etc. A locality composes of many individual addresses.
    Example: "Sankt Gallen"

  - `banks.addresses.formattedAddress.district` (string)
    Type of administrative division that, in some countries, is managed by local government. Across the world, areas known as "districts" vary greatly in size, spanning regions or counties, several municipalities, subdivisions of municipalities, school district, or political district.
    Example: "City center"

  - `banks.addresses.formattedAddress.postalCode` (string)
    A country specific code for a certain address.
    Example: "9000"

  - `banks.addresses.formattedAddress.thoroughfare` (string)
    Details of the access route along which buildings, lots, or land are located, such as street, road, channel, crescent, avenue.
    Example: "Lukassstrasse"

  - `banks.addresses.formattedAddress.premise` (string)
    A premise is a tract of land including its buildings. A premise may have several sub-levels to precisely identify.
    Example: "Lukasstraße 4, Building 2, Floor 3, Room 4"

  - `banks.addresses.formattedAddress.interurbanDeliveryPoint` (string)
    A single mailbox or other place at which postal mail is delivered.
    Example: "Sankt Gallen, Postfach 460"

  - `banks.addresses.formattedAddress.mailbox` (string)
    A location at an address where the post is delivered to.
    Example: "Postfach 460"

  - `banks.addresses.formattedAddress.postOfficeBox` (string)
    A uniquely addressable lockable box located on the premises of a post office station.
    Example: "Postfach 460"

  - `banks.addresses.cdqId` (string)
    Unique identifier which identifies a Business Partner with one address. The same address versions has the same cdq ID.
    Example: "CDQID-1234567890"

  - `banks.externalId` (string)
    ID the record has in the external system where the record originates from.
    Example: "DE2357422"

  - `banks.relations` (array)

  - `banks.relations.startedAt` (string)
    ISO 8601 representation of the timestamp when the relation was created.
    Example: "2025-08-29T09:46:42Z"

  - `banks.relations.endedAt` (string)
    ISO 8601 representation of the timestamp when the relation ended.
    Example: "2025-08-29T09:46:42Z"

  - `banks.relations.type` (object)
    Type of the relation.

  - `banks.relations.type.technicalKey` (string)
    Technical key of the relation type.
    Example: "BRANCH"

  - `banks.relations.type.name` (string)
    Name of the relation type.
    Example: "Organizational Unit"

  - `banks.relations.startNode` (string)
    CDQ ID of the starting node.
    Example: "FR.RC:5664645"

  - `banks.relations.endNode` (string)
    CDQ ID of the target node.
    Example: "FR.RC:5664645"

  - `banks.dataSourceId` (string)
    Unique identifier for a Data Source of the Storage.
    Example: "648824a691d8d2503d65103e"

  - `banks.rawData` (object)
    Raw data of the bank.

## Response 200 fields (application/json):

  - `numberOfAccepted` (integer)
    Number of bank upserts accepted.
    Example: "10"

  - `numberOfFailed` (integer)
    Number of banks upsert failed.
    Example: "1"

  - `failures` (array)
    List of bank upsert failures.

  - `failures.bank` (object)
    -> Represents a bank with properties such as the unique identifier of the bank, its name, and the country code.

  - `failures.bank.names` (array)
    Name of a bank.
    Example: "Swiss National Bank"

  - `failures.bank.names.shortName` (string)
    Abbreviated name of a bank.
    Example: "SNB"

  - `failures.bank.names.type` (object)
    Type of the Bank Name.

  - `failures.bank.names.type.url` (string)
    URL to the documentation which summarizes all details of the Bank Name Type.
    Example: "https://meta.cdq.com/Bank_account/bank/name/type"

  - `failures.bank.names.type.name` (string)
    Name of the Bank Name Type.
    Example: "Bank name acronym"

  - `failures.bank.names.type.technicalKey` (string)
    Technical key of the Bank Name Type.
    Example: "BANK_NAME_TYPE_ACRONYM"

  - `failures.bank.names.value` (string)
    Value of the Bank Name.
    Example: "Swiss National Bank"

  - `failures.bank.names.version` (object)
    Specifies the version of a bank name in terms of language and charset.

  - `failures.bank.names.version.charset` (object)
    Character set.

  - `failures.bank.names.version.charset.name` (string)
    Name of character set. Supported character sets can be found [here](https://meta.cdq.com/Address/version/character_set).
    Example: "International"

  - `failures.bank.names.version.charset.technicalKey` (string)
    Technical key of character set. Supported character sets can be found [here](https://meta.cdq.com/Address/version/character_set).
    Example: "INTERNATIONAL"

  - `failures.bank.names.version.language` (object)
    Naming of a language according to ISO 639-1.

  - `failures.bank.names.version.language.name` (string)
    ISO 639-1 name of language.
    Example: "German"

  - `failures.bank.names.version.language.technicalKey` (string)
    ISO 639-1 two-letter code of languages.
    Example: "DE"

  - `failures.bank.contact` (object)
    Bank contact information.

  - `failures.bank.contact.emails` (array)

  - `failures.bank.contact.emails.address` (string)
    An actual email address of the bank.
    Example: "info@cdq.com"

  - `failures.bank.contact.emails.type` (object)
    A type of a email address of the bank.

  - `failures.bank.contact.emails.type.name` (string)
    Name of the Bank Contact Email Type.
    Example: "Bank contact email"

  - `failures.bank.contact.emails.type.url` (string)
    URL to the documentation which summarizes all details of the Bank Contact Email Type.
    Example: "https://meta.cdq.com/Bank_account/bank/contact/contact_email/type"

  - `failures.bank.contact.emails.type.technicalKey` (string)
    Technical key of the Bank Contact Email Type.
    Example: "BANK_CONTACT_EMAIL_TYPE"

  - `failures.bank.contact.phoneNumbers` (array)

  - `failures.bank.contact.phoneNumbers.countryPrefix` (string)
    A country prefix of a bank phone number.
    Example: "0041"

  - `failures.bank.contact.phoneNumbers.number` (string)
    A complete phone number of the bank without any country prefixes.
    Example: "58 631 00 00"

  - `failures.bank.contact.phoneNumbers.type` (object)
    A type of the bank phone number.

  - `failures.bank.contact.phoneNumbers.type.name` (string)
    Name of the Bank Contact Phone Number Type.
    Example: "Bank contact phone number"

  - `failures.bank.contact.phoneNumbers.type.url` (string)
    URL to the documentation which summarizes all details of the Bank Contact Phone Number Type.
    Example: "https://meta.cdq.com/Bank_account/bank/contact/phone_number/type"

  - `failures.bank.contact.phoneNumbers.type.technicalKey` (string)
    Technical key of the Bank Contact Phone Number Type.
    Example: "BANK_CONTACT_PHONE_TYPE_PHONE"

  - `failures.bank.contact.phoneNumbers.value` (string)
    The actual complete bank phone number incl. country prefix.
    Example: "0041 58 631 00 00"

  - `failures.bank.contact.websites` (array)

  - `failures.bank.contact.websites.url` (string)
    The actual URL of the bank's website.
    Example: "https://cdq.com"

  - `failures.bank.contact.websites.type` (object)
    A type of the bank's website.

  - `failures.bank.contact.websites.type.name` (string)
    Name of the Bank Contact Website Type.
    Example: "Bank contact website"

  - `failures.bank.contact.websites.type.url` (string)
    URL to the documentation which summarizes all details of the Bank Contact Website Type.
    Example: "https://meta.cdq.com/Bank_account/bank/contact/website/type"

  - `failures.bank.contact.websites.type.technicalKey` (string)
    Technical key of the Bank Contact Website Type.
    Example: "BANK_CONTACT_WEBSITE_TYPE"

  - `failures.bank.identifiers` (array)

  - `failures.bank.identifiers.type` (object)
    Type of the Bank Identifier.

  - `failures.bank.identifiers.type.url` (string)
    URL to the documentation which summarizes all details of the Bank Identifier Type.
    Example: "https://meta.cdq.com/Bank_account/bank/identifier/type"

  - `failures.bank.identifiers.type.name` (string)
    Name of the Bank Identifier Type.
    Example: "Bank SWIFT Code"

  - `failures.bank.identifiers.type.technicalKey` (string)
    Technical Key of the Bank Identifier Type.
    Example: "WR_BSC"

  - `failures.bank.identifiers.value` (string)
    The actual value of the bank identifier.
    Example: "CH1234567890123456789"

  - `failures.bank.identifiers.issuingBody` (object)
    An Issuing Body is an organization or government institution that is responsible for assigning unique identifiers to individuals, organizations, or objects.

  - `failures.bank.identifiers.issuingBody.name` (string)
    Name of the Bank Issuing Body.
    Example: "Bank Identifier Code"

  - `failures.bank.identifiers.issuingBody.url` (string)
    URL to the documentation which summarizes all details of the Bank Issuing Body.
    Example: "https://meta.cdq.com/Bank_account/bank/identifier/issuing_body"

  - `failures.bank.identifiers.issuingBody.technicalKey` (string)
    Technical Key of the Bank Issuing Body.
    Example: "BIC"

  - `failures.bank.identifiers.status` (object)
    Status of the identifier.

  - `failures.bank.identifiers.status.name` (string)
    Name of the Identifier Status.
    Example: "Active"

  - `failures.bank.identifiers.status.technicalKey` (string)
    Technical key of the Identifier Status.
    Example: "ACTIVE"

  - `failures.bank.addresses` (array)
    List of addresses.

  - `failures.bank.addresses.version` (object)
    CDQ supports multiple versions of addresses comprising different charsets and languages. An address version is a unique combination of a character set and a language.

  - `failures.bank.addresses.version.characterSet` (object)
    Character set.

  - `failures.bank.addresses.version.characterSet.name` (any)

  - `failures.bank.addresses.version.characterSet.technicalKey` (any)

  - `failures.bank.addresses.identifyingName` (object)
    An identifying name assigned to an address. In most cases the identifying name refers to the name of a registered agent.

  - `failures.bank.addresses.identifyingName.value` (string)
    An identifying name assigned to an address. In most cases the identifying name refers to the name of a registered agent.
    Example: "John Doe"

  - `failures.bank.addresses.externalId` (string)
    ID the address has in the external system where the record originates from.
    Example: "1"

  - `failures.bank.addresses.metadata` (object)
    Specifies the language and primary data provenance.

  - `failures.bank.addresses.metadata.primaryProvenance` (object)
    The source of the change or update. Could be the reference data source as VIES or Organization.

  - `failures.bank.addresses.metadata.primaryProvenance.url` (any)

  - `failures.bank.addresses.metadata.primaryProvenance.cdqId` (any)

  - `failures.bank.addresses.careOf` (object)
    Signifies an intermediary who is responsible for transferring a piece of mail between the postal system and the final addressee. For example, when the addressee has no standard address, is under a corporate mail system, or is being manually forwarded mail sent to a more accessible location.

  - `failures.bank.addresses.careOf.value` (string)
    Value of the CareOf.
    Example: "CDQ GmbH c/o Product Department"

  - `failures.bank.addresses.contexts` (array)

  - `failures.bank.addresses.contexts.value` (any)

  - `failures.bank.addresses.country` (object)
    Country consisting of the country name and country code (ISO 3166-1 alpha-2).

  - `failures.bank.addresses.country.shortName` (string)
    Country code (ISO 3166-1 alpha-2).
    Example: "CH"

  - `failures.bank.addresses.country.value` (string)
    Country name (ISO 3166-1 alpha-2).
    Example: "Switzerland"

  - `failures.bank.addresses.administrativeAreas` (array)

  - `failures.bank.addresses.administrativeAreas.shortName` (any)

  - `failures.bank.addresses.administrativeAreas.fipsCode` (any)

  - `failures.bank.addresses.administrativeAreas.isoCode` (any)

  - `failures.bank.addresses.administrativeAreas.type` (any)

  - `failures.bank.addresses.administrativeAreas.language` (any)

  - `failures.bank.addresses.postCodes` (array)
    Example: ["9000"]

  - `failures.bank.addresses.localities` (array)

  - `failures.bank.addresses.thoroughfares` (array)

  - `failures.bank.addresses.thoroughfares.number` (any)

  - `failures.bank.addresses.thoroughfares.direction` (any)

  - `failures.bank.addresses.premises` (array)

  - `failures.bank.addresses.postalDeliveryPoints` (array)

  - `failures.bank.addresses.openingHours` (array)

  - `failures.bank.addresses.openingHours.openingHour` (any)

  - `failures.bank.addresses.openingHours.closingHour` (any)

  - `failures.bank.addresses.openingHours.weekday` (any)

  - `failures.bank.addresses.geographicCoordinates` (object)
    Decimal geographic coordinates (WGS 84 - reference coordinate system).

  - `failures.bank.addresses.geographicCoordinates.latitude` (number)
    Plain on the earth's surface north or south of the equator.
    Example: "47.439549"

  - `failures.bank.addresses.geographicCoordinates.longitude` (number)
    Plain on the earth's surface east or west of a meridian.
    Example: "9.395275"

  - `failures.bank.addresses.types` (array)

  - `failures.bank.addresses.formattedAddress` (object)
    A formatted address is a structured address of VIES data source.

  - `failures.bank.addresses.formattedAddress.country` (string)
    Country name.
    Example: "Switzerland"

  - `failures.bank.addresses.formattedAddress.administrativeArea` (string)
    A top-level geographical or political area division in a country.
    Example: "Sankt Gallen"

  - `failures.bank.addresses.formattedAddress.region` (string)
    Top level subdivision of a country.
    Example: "Sankt Gallen"

  - `failures.bank.addresses.formattedAddress.regionCode` (string)
    A country specific code for a certain address in the region.
    Example: "9004"

  - `failures.bank.addresses.formattedAddress.locality` (string)
    A locality is a named densely populated area (a place) such as town, village, suburb, etc. A locality composes of many individual addresses.
    Example: "Sankt Gallen"

  - `failures.bank.addresses.formattedAddress.district` (string)
    Type of administrative division that, in some countries, is managed by local government. Across the world, areas known as "districts" vary greatly in size, spanning regions or counties, several municipalities, subdivisions of municipalities, school district, or political district.
    Example: "City center"

  - `failures.bank.addresses.formattedAddress.postalCode` (string)
    A country specific code for a certain address.
    Example: "9000"

  - `failures.bank.addresses.formattedAddress.thoroughfare` (string)
    Details of the access route along which buildings, lots, or land are located, such as street, road, channel, crescent, avenue.
    Example: "Lukassstrasse"

  - `failures.bank.addresses.formattedAddress.premise` (string)
    A premise is a tract of land including its buildings. A premise may have several sub-levels to precisely identify.
    Example: "Lukasstraße 4, Building 2, Floor 3, Room 4"

  - `failures.bank.addresses.formattedAddress.interurbanDeliveryPoint` (string)
    A single mailbox or other place at which postal mail is delivered.
    Example: "Sankt Gallen, Postfach 460"

  - `failures.bank.addresses.formattedAddress.mailbox` (string)
    A location at an address where the post is delivered to.
    Example: "Postfach 460"

  - `failures.bank.addresses.formattedAddress.postOfficeBox` (string)
    A uniquely addressable lockable box located on the premises of a post office station.
    Example: "Postfach 460"

  - `failures.bank.addresses.cdqId` (string)
    Unique identifier which identifies a Business Partner with one address. The same address versions has the same cdq ID.
    Example: "CDQID-1234567890"

  - `failures.bank.externalId` (string)
    ID the record has in the external system where the record originates from.
    Example: "DE2357422"

  - `failures.bank.relations` (array)

  - `failures.bank.relations.startedAt` (string)
    ISO 8601 representation of the timestamp when the relation was created.
    Example: "2025-08-29T09:46:42Z"

  - `failures.bank.relations.endedAt` (string)
    ISO 8601 representation of the timestamp when the relation ended.
    Example: "2025-08-29T09:46:42Z"

  - `failures.bank.relations.type` (object)
    Type of the relation.

  - `failures.bank.relations.type.technicalKey` (string)
    Technical key of the relation type.
    Example: "BRANCH"

  - `failures.bank.relations.type.name` (string)
    Name of the relation type.
    Example: "Organizational Unit"

  - `failures.bank.relations.startNode` (string)
    CDQ ID of the starting node.
    Example: "FR.RC:5664645"

  - `failures.bank.relations.endNode` (string)
    CDQ ID of the target node.
    Example: "FR.RC:5664645"

  - `failures.bank.dataSourceId` (string)
    Unique identifier for a Data Source of the Storage.
    Example: "648824a691d8d2503d65103e"

  - `failures.bank.rawData` (object)
    Raw data of the bank.

  - `failures.bank.id` (string)
    The Technical ID of the Bank entry.
    Example: "CH1234567890123456789"

  - `failures.bank.createdAt` (string)
    Date of creation (ISO 8601-compliant).
    Example: "2025-08-29T09:46:42Z"

  - `failures.bank.lastModifiedAt` (string)
    Date of modification (ISO 8601-compliant).
    Example: "2025-08-29T09:46:42Z"

  - `failures.message` (string)
    Failure message.
    Example: "This record could not be stored due to timeout."