# Lookup Bank Information Lookup bank information based on the given bank data lookup request. Endpoint: POST /banks/lookup Version: 2 Security: apiKey ## Request fields (application/json): - `bank` (object) Query for bank lookup. - `bank.names` (array) List of bank names to search for. - `bank.names.value` (string) Name of the Bank. Example: "Deutsche Bank" - `bank.identifiers` (array) List of bank identifiers to search for. - `bank.identifiers.value` (string) Identifier Value. Example: "DEUTDEFF" - `bank.identifiers.type` (object) Query for identifier type lookup. - `bank.identifiers.type.technicalKey` (string) Technical Key of the identifier. Example: "CH_VAT_ID" - `bank.addresses` (array) List of addresses to search for. - `bank.addresses.thoroughfares` (array) List of thoroughfares to search for. - `bank.addresses.thoroughfares.value` (string) The name of the street. It can contain the street number. Example: "Musterstraße 12" - `bank.addresses.thoroughfares.number` (string) The number of the street. Example: "12" - `bank.addresses.localities` (array) List of localities to search for. - `bank.addresses.localities.value` (string) Locality Value. Example: "Wrocław" - `bank.addresses.postCodes` (array) List of post codes to search for. - `bank.addresses.postCodes.value` (string) The post code of the address. Example: "59400" - `bank.addresses.country` (object) Query for country lookup. - `bank.addresses.country.shortName` (string) Short name of the country. Example: "DE" - `matchingThreshold` (number) The minimum matching score that a bank must have to be included in the result set. Default: 0.0. Example: "0.5" - `maxCandidates` (integer) The maximum number of candidates that should be returned. Example: "50" - `pageSize` (integer) The number of results that should be fetched. Maximum 1000 results can be returned in one page. Default: 10. Example: "100" - `page` (integer) The number of page. Example: "0" ## Response 200 fields (application/json): - `pageSize` (integer) Number of items per page. Example: "100" - `totals` (integer) Total number of items which can be paged. Example: "67" - `page` (integer) Current page number. Example: "1" - `values` (array) List of bank data matches. - `values.cdqId` (string) Unique id which defines a Bank Entry with exactly one address. Pattern: . Example: "VIES:543456-7820" - `values.dataSource` (object) Data Source of the Data Pool. - `values.dataSource.id` (string) Unique identifier for a Data Source of the Storage. Example: "648824a691d8d2503d65103e" - `values.dataSource.url` (string) Documentation of the data source in the CDQ Wiki. Example: "https://meta.cdq.com/Data_source/BR.RF" - `values.dataSource.name` (string) Name of the data source. Example: "Receita Federal Brazil" - `values.dataSource.technicalKey` (string) Technical key of the data source. Example: "BR_RF" - `values.bank` (object) Financial institution that accepts deposits, facilitates withdrawals and transfers, and provides various financial services such as loans, investments, and currency exchange. - `values.bank.names` (array) Name of a bank. Example: "Swiss National Bank" - `values.bank.names.shortName` (string) Abbreviated name of a bank. Example: "SNB" - `values.bank.names.type` (object) Type of the Bank Name. - `values.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" - `values.bank.names.type.name` (string) Name of the Bank Name Type. Example: "Bank name acronym" - `values.bank.names.type.technicalKey` (string) Technical key of the Bank Name Type. Example: "BANK_NAME_TYPE_ACRONYM" - `values.bank.names.value` (string) Value of the Bank Name. Example: "Swiss National Bank" - `values.bank.names.version` (object) Specifies the version of a bank name in terms of language and charset. - `values.bank.names.version.charset` (object) Character set. - `values.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" - `values.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" - `values.bank.names.version.language` (object) Naming of a language according to ISO 639-1. - `values.bank.names.version.language.name` (string) ISO 639-1 name of language. Example: "German" - `values.bank.names.version.language.technicalKey` (string) ISO 639-1 two-letter code of languages. Example: "DE" - `values.bank.contact` (object) Bank contact information. - `values.bank.contact.emails` (array) - `values.bank.contact.emails.address` (string) An actual email address of the bank. Example: "info@cdq.com" - `values.bank.contact.emails.type` (object) A type of a email address of the bank. - `values.bank.contact.emails.type.name` (string) Name of the Bank Contact Email Type. Example: "Bank contact email" - `values.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" - `values.bank.contact.emails.type.technicalKey` (string) Technical key of the Bank Contact Email Type. Example: "BANK_CONTACT_EMAIL_TYPE" - `values.bank.contact.phoneNumbers` (array) - `values.bank.contact.phoneNumbers.countryPrefix` (string) A country prefix of a bank phone number. Example: "0041" - `values.bank.contact.phoneNumbers.number` (string) A complete phone number of the bank without any country prefixes. Example: "58 631 00 00" - `values.bank.contact.phoneNumbers.type` (object) A type of the bank phone number. - `values.bank.contact.phoneNumbers.type.name` (string) Name of the Bank Contact Phone Number Type. Example: "Bank contact phone number" - `values.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" - `values.bank.contact.phoneNumbers.type.technicalKey` (string) Technical key of the Bank Contact Phone Number Type. Example: "BANK_CONTACT_PHONE_TYPE_PHONE" - `values.bank.contact.phoneNumbers.value` (string) The actual complete bank phone number incl. country prefix. Example: "0041 58 631 00 00" - `values.bank.contact.websites` (array) - `values.bank.contact.websites.url` (string) The actual URL of the bank's website. Example: "https://cdq.com" - `values.bank.contact.websites.type` (object) A type of the bank's website. - `values.bank.contact.websites.type.name` (string) Name of the Bank Contact Website Type. Example: "Bank contact website" - `values.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" - `values.bank.contact.websites.type.technicalKey` (string) Technical key of the Bank Contact Website Type. Example: "BANK_CONTACT_WEBSITE_TYPE" - `values.bank.identifiers` (array) - `values.bank.identifiers.type` (object) Type of the Bank Identifier. - `values.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" - `values.bank.identifiers.type.name` (string) Name of the Bank Identifier Type. Example: "Bank SWIFT Code" - `values.bank.identifiers.type.technicalKey` (string) Technical Key of the Bank Identifier Type. Example: "WR_BSC" - `values.bank.identifiers.value` (string) The actual value of the bank identifier. Example: "CH1234567890123456789" - `values.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. - `values.bank.identifiers.issuingBody.name` (string) Name of the Bank Issuing Body. Example: "Bank Identifier Code" - `values.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" - `values.bank.identifiers.issuingBody.technicalKey` (string) Technical Key of the Bank Issuing Body. Example: "BIC" - `values.bank.identifiers.status` (object) Status of the identifier. - `values.bank.identifiers.status.name` (string) Name of the Identifier Status. Example: "Active" - `values.bank.identifiers.status.technicalKey` (string) Technical key of the Identifier Status. Example: "ACTIVE" - `values.bank.addresses` (array) - `values.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. - `values.bank.addresses.version.characterSet` (object) Character set. - `values.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. - `values.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" - `values.bank.addresses.externalId` (string) ID the address has in the external system where the record originates from. Example: "1" - `values.bank.addresses.metadata` (object) Specifies the language and primary data provenance. - `values.bank.addresses.metadata.primaryProvenance` (object) The source of the change or update. Could be the reference data source as VIES or Organization. - `values.bank.addresses.metadata.primaryProvenance.name` (string) Display Name of the Provenance Name. Example: "VIES" - `values.bank.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=" - `values.bank.addresses.metadata.primaryProvenance.technicalKey` (string) Technical Key of the Provenance Name. Example: "VIES" - `values.bank.addresses.metadata.primaryProvenance.cdqId` (string) The ID provided for a linkage with the source by CDQ. Example: "VIES:PL8660001429" - `values.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. - `values.bank.addresses.careOf.value` (string) Value of the CareOf. Example: "CDQ GmbH c/o Product Department" - `values.bank.addresses.contexts` (array) - `values.bank.addresses.contexts.value` (string) Value of the Address Context. Example: "Production hall 7, Storage field 8." - `values.bank.addresses.country` (object) Country consisting of the country name and country code (ISO 3166-1 alpha-2). - `values.bank.addresses.country.shortName` (string) Country code (ISO 3166-1 alpha-2). Example: "CH" - `values.bank.addresses.country.value` (string) Country name (ISO 3166-1 alpha-2). Example: "Switzerland" - `values.bank.addresses.administrativeAreas` (array) - `values.bank.addresses.administrativeAreas.value` (string) Name of the [Administrative Area](https://meta.cdq.com/Address/administrative_area). Example: "Sankt Gallen" - `values.bank.addresses.administrativeAreas.shortName` (string) Abbreviation for the [Administrative Area](https://meta.cdq.com/Address/administrative_area). Example: "SG" - `values.bank.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" - `values.bank.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" - `values.bank.addresses.administrativeAreas.type` (object) Type of the [Administrative Area](https://meta.cdq.com/Address/administrative_area). - `values.bank.addresses.administrativeAreas.type.name` (string) Display label for the Administrative Area Type. Example: "COUNTY" - `values.bank.addresses.administrativeAreas.type.url` (string) URL to the documentation which summarizes all details of the [Administrative Area](https://meta.cdq.com/Address/administrative_area/type). Example: "https://meta.cdq.com/Address/administrative_area/type" - `values.bank.addresses.administrativeAreas.type.technicalKey` (string) Technical key of the Administrative Area. Example: "COUNTY" - `values.bank.addresses.postCodes` (array) Example: ["9000"] - `values.bank.addresses.postCodes.value` (string) Effective [post code](https://meta.cdq.com/Address/post_code). Example: "9000" - `values.bank.addresses.postCodes.type` (object) Type of the Post Code. - `values.bank.addresses.postCodes.type.name` (string) Display label for the Post Code Type. Example: "Regular" - `values.bank.addresses.postCodes.type.url` (string) URL to the documentation which summarizes all details of the [Administrative Area](https://meta.cdq.com/Address/post_code/type). Example: "https://meta.cdq.com/Address/post_code/type" - `values.bank.addresses.postCodes.type.technicalKey` (string) Technical key of the Post Code. Example: "REGULAR" - `values.bank.addresses.localities` (array) - `values.bank.addresses.localities.type` (object) Type of the [Locality](https://meta.cdq.com/Address/locality). - `values.bank.addresses.localities.type.name` (string) Display label for the Locality Type. Example: "City" - `values.bank.addresses.localities.type.url` (string) URL to the documentation which summarizes all details of the [Locality Type](https://meta.cdq.com/Address/locality/type). Example: "https://meta.cdq.com/Address/locality/type" - `values.bank.addresses.localities.type.technicalKey` (string) Technical Key of the Locality Type. Example: "CITY" - `values.bank.addresses.localities.shortName` (string) Abbreviation of the [Locality](https://meta.cdq.com/Address/locality). Example: "St. Gallen" - `values.bank.addresses.localities.value` (string) Name of the [Locality](https://meta.cdq.com/Address/locality). Example: "Sankt Gallen" - `values.bank.addresses.thoroughfares` (array) - `values.bank.addresses.thoroughfares.type` (object) Type of the [Thoroughfare](https://meta.cdq.com/Address/thoroughfare). - `values.bank.addresses.thoroughfares.type.name` (string) Display label for the Thoroughfare Type Name. Example: "Industrial zone" - `values.bank.addresses.thoroughfares.type.url` (string) URL to the documentation which summarizes all details of the [Thoroughfare Type](https://meta.cdq.com/Address/thoroughfare/type). Example: "https://meta.cdq.com/Address/thoroughfare/type" - `values.bank.addresses.thoroughfares.type.technicalKey` (string) Technical key of the Thoroughfare Type. Example: "INDUSTRIAL_ZONE" - `values.bank.addresses.thoroughfares.shortName` (string) Abbreviation of the [Thoroughfare](https://meta.cdq.com/Address/thoroughfare). Example: "Lukasstr. 4" - `values.bank.addresses.thoroughfares.number` (string) Number of the [Thoroughfare](https://meta.cdq.com/Address/thoroughfare). Example: "4" - `values.bank.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" - `values.bank.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" - `values.bank.addresses.thoroughfares.direction` (string) Direction of the [Thoroughfare](https://meta.cdq.com/Address/thoroughfare). Example: "221-bis Baker Street, North" - `values.bank.addresses.premises` (array) - `values.bank.addresses.premises.value` (string) The actual value of a Premise in the language of the address. Example: "Lukasstraße 4" - `values.bank.addresses.premises.shortName` (string) Abbreviation of the Premise. Example: "Lukasstr. 4" - `values.bank.addresses.premises.number` (string) Number of the Premise. Example: "4" - `values.bank.addresses.premises.type` (object) Type of the Premise. - `values.bank.addresses.premises.type.name` (string) Display label for the Premise Type. Example: "Factory" - `values.bank.addresses.premises.type.url` (string) URL to the documentation which summarizes all details of the [Premise Type](https://meta.cdq.com/Address/premise/type). Example: "https://meta.cdq.com/Address/premise/type" - `values.bank.addresses.premises.type.technicalKey` (string) Technical key of the Premise Type. Example: "FACTORY" - `values.bank.addresses.postalDeliveryPoints` (array) - `values.bank.addresses.postalDeliveryPoints.type` (object) A single mailbox or other place at which postal mail is delivered. - `values.bank.addresses.postalDeliveryPoints.type.name` (string) Display label for the Postal Delivery Point Type. Example: "Mailbox" - `values.bank.addresses.postalDeliveryPoints.type.url` (string) URL to the documentation which summarizes all details of the [Postal Delivery Point](https://meta.cdq.com/Address/postal_delivery_point/type) Example: "https://meta.cdq.com/Address/postal_delivery_point/type" - `values.bank.addresses.postalDeliveryPoints.type.technicalKey` (string) Technical key of the Postal Delivery Point. Example: "MAILBOX" - `values.bank.addresses.postalDeliveryPoints.shortName` (string) Stort name of the [Postal Delivery Point](https://meta.cdq.com/Address/postal_delivery_point). Example: "St Gallen, Postfach 460" - `values.bank.addresses.postalDeliveryPoints.number` (string) Number of the [Postal Delivery Point](https://meta.cdq.com/Address/postal_delivery_point). Example: "460" - `values.bank.addresses.postalDeliveryPoints.value` (string) Value of the [Postal Delivery Point](https://meta.cdq.com/Address/postal_delivery_point). Example: "Postfach" - `values.bank.addresses.openingHours` (array) - `values.bank.addresses.openingHours.openingHour` (string) Company openning hour. Example: "09:00 AM" - `values.bank.addresses.openingHours.closingHour` (string) Company closing hour. Example: "05:00 PM" - `values.bank.addresses.openingHours.weekday` (string) A day in the week in which the company is open. Example: "Monday" - `values.bank.addresses.geographicCoordinates` (object) Decimal geographic coordinates (WGS 84 - reference coordinate system). - `values.bank.addresses.geographicCoordinates.latitude` (number) Plain on the earth's surface north or south of the equator. Example: "47.439549" - `values.bank.addresses.geographicCoordinates.longitude` (number) Plain on the earth's surface east or west of a meridian. Example: "9.395275" - `values.bank.addresses.types` (array) - `values.bank.addresses.types.name` (string) Display label for the Address Type. Example: "Legal Address" - `values.bank.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" - `values.bank.addresses.types.technicalKey` (string) Technical key of the Address Type. Example: "LEGAL_ADDRESS" - `values.bank.addresses.formattedAddress` (object) A formatted address is a structured address of VIES data source. - `values.bank.addresses.formattedAddress.country` (string) Country name. Example: "Switzerland" - `values.bank.addresses.formattedAddress.administrativeArea` (string) A top-level geographical or political area division in a country. Example: "Sankt Gallen" - `values.bank.addresses.formattedAddress.region` (string) Top level subdivision of a country. Example: "Sankt Gallen" - `values.bank.addresses.formattedAddress.regionCode` (string) A country specific code for a certain address in the region. Example: "9004" - `values.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" - `values.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" - `values.bank.addresses.formattedAddress.postalCode` (string) A country specific code for a certain address. Example: "9000" - `values.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" - `values.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" - `values.bank.addresses.formattedAddress.interurbanDeliveryPoint` (string) A single mailbox or other place at which postal mail is delivered. Example: "Sankt Gallen, Postfach 460" - `values.bank.addresses.formattedAddress.mailbox` (string) A location at an address where the post is delivered to. Example: "Postfach 460" - `values.bank.addresses.formattedAddress.postOfficeBox` (string) A uniquely addressable lockable box located on the premises of a post office station. Example: "Postfach 460" - `values.bank.externalId` (string) ID the record has in the external system where the record originates from. Example: "DE2357422" - `values.bank.relations` (array) - `values.bank.relations.startedAt` (string) ISO 8601 representation of the timestamp when the relation was created. Example: "2025-08-29T09:46:42Z" - `values.bank.relations.endedAt` (string) ISO 8601 representation of the timestamp when the relation ended. Example: "2025-08-29T09:46:42Z" - `values.bank.relations.type` (object) Type of the relation. - `values.bank.relations.type.technicalKey` (string) Technical key of the relation type. Example: "BRANCH" - `values.bank.relations.type.name` (string) Name of the relation type. Example: "Organizational Unit" - `values.bank.relations.startNode` (string) CDQ ID of the starting node. Example: "FR.RC:5664645" - `values.bank.relations.endNode` (string) CDQ ID of the target node. Example: "FR.RC:5664645" - `values.matchingProfile` (object) Matching profile used for the match. It contains the matching threshold and the matching scores. - `values.matchingProfile.matchingScores` (object) List of the numerical value of similarity between Business Partners or addresses enhanced with the overall score. - `values.matchingProfile.matchingScores.overall` (object) Shows numerical value of similarity between Business Partners or address stored in the Data Mirror and the Business Partner from the request. - `values.matchingProfile.matchingScores.overall.classification` (object) Classification of the matching score. The higher the score, the better the match. - `values.matchingProfile.matchingScores.overall.classification.technicalKey` (string) Define how good are the matches. Allowed values are: FULL_MATCH, MAYBE_MATCH, NO_MATCH. Example: "FULL_MATCH" - `values.matchingProfile.matchingScores.overall.classification.name` (string) Name of the Matching Classification. Example: "My Matching Configuration" - `values.matchingProfile.matchingScores.overall.value` (number) Matching score value. Example: "0.9" - `values.matchingProfile.matchingScores.overall.explanation` (string) Explanation for matching score value. Example: "BP: [overall: [IDENTIFIER: 0.55; overall: 0.55;]] A: [overall: [COUNTRY_SHORTNAME: 0.5; overall: 0.5;]]" - `values.matchingProfile.matchingScores.bank` (object) Shows numerical value of similarity between Business Partners or address stored in the Data Mirror and the Business Partner from the request. - `values.matchingProfile.matchingScores.address` (object) Shows numerical value of similarity between Business Partners or address stored in the Data Mirror and the Business Partner from the request.