# Lookup Business Partners Perform a Business Partner lookup operation across all available Data Sources. The output of this operation will be a comprehensive list of Business Partners, each accompanied by their respective Data Sources and meticulously calculated matching scores. It is important to note that all accessible data sources are comprehensively documented within the Data_source Category on CDQ Wiki. The Data Sources are categorized as follows: * OPEN: These Data Sources are open to everyone without any registration requirement. * FREE: These Data Sources are free to use, but registration is required. * COMMERCIAL: These Data Sources are only available to commercial users. The results of the Business Partner lookup operation are sorted in descending order based on their matching scores. Additionally, the results are conveniently paginated, allowing for efficient navigation through the extensive list. The page size can be effortlessly customized to accommodate specific preferences. Endpoint: POST /referencedata/rest/v4/businesspartners/lookup Version: 3 Security: apiKey ## Request fields (application/json): - `limit` (integer) Number of items per page. Default value is 10. Example: "10" - `startAfter` (string) The ID which is used to read the page. Example: "5712566172571652" - `dataSources` (array) Filter data sources used during lookup. Example: ["VIES"] - `matchingThreshold` (number) Matching threshold for the lookup process. Default value is 0.5. Example: "0.5" - `maxCandidates` (integer) Maximum number of candidates to be returned. Default value is 50. Example: "50" - `storagesDataSources` (array) This field allows to filter data mirrors that will be queried. For each data mirror, data sources can also be filtered. Leave empty to include all available data mirrors in query. - `storagesDataSources.storageId` (string) ID of data mirror to be included during lookup. Example: "6479fd136811f0361e083211" - `storagesDataSources.dataSources` (array) IDs of data sources in specified data mirror to be included during lookup. Leave empty to include all data sources. - `storagesDataSources.dataSources.id` (string) ID of data mirror to be included during lookup. Example: "6479fd136811f0361e083211" - `featuresOn` (array) List of features to be activated. Enum: "ACTIVATE_IDENTIFIER_ONLY_MATCH", "ACTIVATE_DATASOURCE_STORAGES", "ACTIVATE_DATASOURCE_GOOGLEPLACES", "ACTIVATE_DATASOURCE_ZEFIX", "ACTIVATE_DATASOURCE_NLBR", "ACTIVATE_DATASOURCE_CDL", "ACTIVATE_DATASOURCE_DNB", "ACTIVATE_DATASOURCE_BZST", "ACTIVATE_DATASOURCE_VIES_FOR_ES", "ACTIVATE_DATASOURCE_BVD", "ENABLE_IDENTIFIER_DERIVATION", "ENABLE_TRANSLITERATION_MATCHING", "FORCE_EXTERNAL_CALL", "MATCHING_SCORE_CALCULATION", "LAB_ALLOW_BIG_CANDIDATES", "LAB_ALLOW_LONG_EXTERNAL_CALLS", "LAB_PREFIX_QUERY", "SHOW_DEBUG_INFO", "SHOW_FORMATTED_ADDRESS", "SHOW_FORMATTED_SAP_RECORD", "SHOW_GOLDENRECORD_STANDARD", "SHOW_GOLDENRECORD_QUICK", "GOLDENRECORD_INLINE", "GOLDENRECORD_INLINE_SORTED", "SHOW_INCOMPLETE_CANDIDATES", "SHOW_REGISTERED_INDIVIDUAL", "SHOW_SUBSCRIPTION_METADATA", "FORCE_DATA_SOURCES_INTERSECTION", "ACTIVATE_MASTER_DATA_BASIC_BVD", "ACTIVATE_MASTER_DATA_EXTENDED_BVD", "ACTIVATE_FINANCIAL_RISK_DATA_BVD", "ACTIVATE_OWNERSHIP_DATA_BVD" - `featuresOff` (array) List of features to be deactivated. Enum: "ACTIVATE_IDENTIFIER_ONLY_MATCH", "ACTIVATE_DATASOURCE_STORAGES", "ACTIVATE_DATASOURCE_GOOGLEPLACES", "ACTIVATE_DATASOURCE_ZEFIX", "ACTIVATE_DATASOURCE_NLBR", "ACTIVATE_DATASOURCE_CDL", "ACTIVATE_DATASOURCE_DNB", "ACTIVATE_DATASOURCE_BZST", "ACTIVATE_DATASOURCE_VIES_FOR_ES", "ACTIVATE_DATASOURCE_BVD", "ENABLE_IDENTIFIER_DERIVATION", "ENABLE_TRANSLITERATION_MATCHING", "FORCE_EXTERNAL_CALL", "MATCHING_SCORE_CALCULATION", "LAB_ALLOW_BIG_CANDIDATES", "LAB_ALLOW_LONG_EXTERNAL_CALLS", "LAB_PREFIX_QUERY", "SHOW_DEBUG_INFO", "SHOW_FORMATTED_ADDRESS", "SHOW_FORMATTED_SAP_RECORD", "SHOW_GOLDENRECORD_STANDARD", "SHOW_GOLDENRECORD_QUICK", "GOLDENRECORD_INLINE", "GOLDENRECORD_INLINE_SORTED", "SHOW_INCOMPLETE_CANDIDATES", "SHOW_REGISTERED_INDIVIDUAL", "SHOW_SUBSCRIPTION_METADATA", "FORCE_DATA_SOURCES_INTERSECTION", "ACTIVATE_MASTER_DATA_BASIC_BVD", "ACTIVATE_MASTER_DATA_EXTENDED_BVD", "ACTIVATE_FINANCIAL_RISK_DATA_BVD", "ACTIVATE_OWNERSHIP_DATA_BVD" - `businessPartner` (object) Refers to an organizational entity engaged in various facets of another organization's business interactions. This collaborative connection often manifests as a customer, supplier, vendor, or service provider. In the CDQ (Corporate Data Quality) framework, the Business Partner assumes a pivotal role as a core managed entity. Each Business Partner is distinctly and globally identifiable through a unique CDQ ID. All pertinent information, including addresses, identifiers, and hierarchical data, is intricately associated with and linked to the specific Business Partner, ensuring comprehensive management and traceability within the system. - `businessPartner.names` (array) List of names of the Business Partner. - `businessPartner.names.value` (string) Value of the concept. Example: "Concept name or value" - `businessPartner.identifiers` (array) List of identifiers of the Business Partner. - `businessPartner.identifiers.value` (string) Value of the identifier. Example: "CHE-218.608.886 HR/MWST" - `businessPartner.identifiers.type` (object) Parameters for Identifier Type concept. - `businessPartner.identifiers.type.technicalKey` (string) Allowed types are documented [here](https://meta.cdq.com/Category:Business_partner/identifier/type) under Technical Key property. Enum: "ABN_AU", "AD_FI_CODE", "AE_BRN", "AE_CCN", "AL_BRN", "AL_COC", "AL_GGN", "AL_TRN", "AM_COC", "AM_GGN", "AM_TRN", "AO_BRN", "AR_AGENT_NO", "AR_CUIT", "AR_IATAIN", "AR_NIP", "AR_PGRTN", "AR_SEN", "AR_UTIK", "AT_ARN", "AT_TRN", "AZ_CCN", "AZ_GGN", "AZ_TRN", "BA_COC", "BA_GGN", "BA_TRN", "BD_CIN", "BD_TIN", "BE_ARN", "BE_BUN", "BE_ENT_NO", "BE_VAT_ID", "BF_BRN", "BG_CCN", "BG_GGN", "BG_SEC_ID", "BG_TAX_ID", "BG_UID", "BH_BRN", "BH_CCN", "BIC_FI", "BI_BRN", "BI_US_AK", "BI_US_CO", "BJ_BRN", "BN_CA", "BN_TIN", "BR_CNPJ", "BR_CPF", "BR_GRT", "BR_ID_AT", "BR_TAX_MUN", "BR_TAX_STATE", "BTW_NUMBER", "BT_TIN", "BUSINESS_REGISTER_ID", "BW_BRN", "BY_BRN", "BY_COC", "BY_GGN", "BY_TRN", "CDN_US_FL", "CF_BRN", "CG_BRN", "CH_UID", "CH_VAT_ID", "CID_NY_US", "CIF_ES", "CIK_US", "CL_RUT", "CM_BRN", "CM_CCN", "CM_TRN", "CN_BRN", "CN_IE", "CN_JP", "CN_US_IA", "CN_VAT_15", "CN_VAT_18", "CO_NIT", "CR_TRN", "CX_BPN", "CVR_DK", "CV_BRN", "CY_CCN", "CY_GGN", "CY_TRN", "CZ_CBN", "CZ_DIC", "CZ_ICO", "CZ_TRN", "DE_BNUM", "DE_TAX_ID", "DJ_BRN", "DUNS_ID", "DZ_BRN", "DZ_CCN", "EE_BRN", "EE_COC", "EE_GGN", "EE_TRN", "EG_BRN", "EG_CCN", "EG_TRN", "EORI", "ES_NIE", "ES_NIF", "ET_BRN", "EU_VAT_ID_AT", "EU_VAT_ID_BE", "EU_VAT_ID_BG", "EU_VAT_ID_CY", "EU_VAT_ID_CZ", "EU_VAT_ID_DE", "EU_VAT_ID_DK", "EU_VAT_ID_EE", "EU_VAT_ID_EL", "EU_VAT_ID_ES", "EU_VAT_ID_FI", "EU_VAT_ID_FR", "EU_VAT_ID_HR", "EU_VAT_ID_HU", "EU_VAT_ID_IE", "EU_VAT_ID_IT", "EU_VAT_ID_LT", "EU_VAT_ID_LU", "EU_VAT_ID_LV", "EU_VAT_ID_MT", "EU_VAT_ID_NL", "EU_VAT_ID_PL", "EU_VAT_ID_PT", "EU_VAT_ID_RO", "EU_VAT_ID_SE", "EU_VAT_ID_SI", "EU_VAT_ID_SK", "EU_VAT_ID_UK", "FID_US_WY", "FR_CCN", "FR_SIREN", "FR_SIRET", "GA_CCN", "GA_TRN", "GE_BRN", "GE_COC", "GE_GGN", "GE_TRN", "GH_BRN", "GH_TRN", "GI_BRN", "GI_CCN", "GI_GGN", "GI_TRN", "GM_BRN", "GN_BRN", "GQ_BRN", "GR_AFM", "GR_BRN", "GR_COC", "GR_GGN", "GR_PERS_ID", "GR_TRN", "GS1_GLN", "GST_CA", "GST_MY", "HN_NTRN", "HR_BRN", "HR_COC", "HR_COMP_ID", "HR_GGN", "HR_TRN", "HST_CA", "HU_TAX_ID", "HU_TIN", "ID_CRN", "ID_NL_OB", "ID_TIN", "ID_TVA_FR", "ID_TVA_LU", "ID_UTR", "ID_VAT_UK", "IN_CIN", "IN_DOCR", "IN_GST", "IN_LBT", "IN_LSN", "IN_MOEDU", "IN_PAN", "IN_SEC", "IN_SERVICE_TAX_ID", "IN_SRN", "IQ_BRN", "IR_CCN", "IS_BRN", "IS_CCN", "IS_GGN", "IT_FISC_ID", "IT_VAT_ID", "JO_CCN", "KE_BRN", "KG_BRN", "KG_COC", "KH_BRN", "KH_TIN", "KM_BRN", "KR_CORP_ID", "KR_CRBN", "KR_VAT_ID", "KVK_NL", "KW_BRN", "KW_CCN", "KZ_BRN", "KZ_CCN", "KZ_GGN", "KZ_TRN", "LA_TIN", "LB_BRN", "LB_CCN", "LEI_ID", "LIN_US_SA", "LK_TIN", "LR_BRN", "LS_BRN", "LT_BRN", "LT_COC", "LT_GGN", "LT_TRN", "LV_GGN", "LV_TRN", "MA_BRN", "MA_CCN", "MA_TRN", "MD_BRN", "MD_COC", "MD_GGN", "MD_TRN", "ME_GGN", "ME_TRN", "MG_BRN", "MK_BRN", "MK_COC", "MK_GGN", "MK_TRN", "ML_BRN", "MM_TIN", "MR_BRN", "MT_BRN", "MT_COC", "MT_GGN", "MT_TRN", "MU_BRN", "MU_TRN", "MV_TIN", "MW_BRN", "MX_CURP", "MX_FTRN", "MX_RFC", "MY_BRN", "MZ_BRN", "NA_BRN", "NE_BRN", "NG_BRN", "NL_SI_ID", "NL_TAX_ID", "NP_TIN", "OM_BRN", "OM_CCN", "PE_RUC", "PH_TAX_ID", "PK_TIN", "PT_NIF", "PL_NIP", "PL_REG", "PL_TAX_ID", "PST_CA", "PT_CCN", "PY_UTR", "QA_BRN", "QA_CCN", "RN_US_OR", "RO_BRN", "RO_CCN", "RO_GGN", "RO_TAX_ID", "RSIN_NL", "RS_BRN", "RU_INN", "RU_KPP", "RU_OFK", "RU_OKPO", "RW_BRN", "SA_BRN", "SA_CCN", "SC_BRN", "SC_CCN", "SD_BRN", "SE_BRN", "SE_ORG_ID", "SI_BRN", "SI_CCN", "SI_GGN", "SI_TAX_ID", "SK_DIC", "SK_ICO", "SK_TRN", "SL_BRN", "SN_BRN", "SN_CCN", "SN_TRN", "SO_BRN", "SPOR_ORG_ID", "SPOR_LOC_ID", "SZ_BRN", "TD_BRN", "TG_BRN", "TH_PERS_ID", "TH_TAX_ID", "TJ_BRN", "TJ_COC", "TJ_GGN", "TJ_TRN", "TL_TIN", "TM_BRN", "TM_COC", "TM_TRN", "TR_BRN", "TR_CCN", "TR_GGN", "TR_TAX_ID", "TR_TAX_OFFICE_ID", "TT_TIN", "TW_BRN", "TW_GUID", "TW_TAX_ID", "TZ_BRN", "UA_BRN", "UA_CCN", "UA_GGN", "UA_TAX_ID", "UA_USREOU", "UBI_US_WS", "UG_BRN", "UK_IN_ID", "UK_VAT_ID", "US_BRN", "US_EMPL_ID", "US_FTIN", "US_SEC_ID", "UZ_BRN", "UZ_COC", "UZ_GGN", "UZ_TRN", "VEN_NL", "VE_NIT", "VE_RIF", "VN_BRN", "VN_TIN", "WR_BSC", "WR_BTRN", "WR_CAGE", "WR_CINS", "WR_CUSIP", "WR_MIN", "XK_BRN", "XK_GGN", "YE_BRN", "YE_CCN", "ZA_TIN", "ZM_BRN", "ZW_BRN", "ZW_COC", "ZW_GGN", "ZW_TRN" - `businessPartner.identifiers.issuingBody` (object) Parameters for Issuing Body concept. - `businessPartner.identifiers.issuingBody.technicalKey` (string) Technical key of the Issuing Body. Example: "Amtsgericht Aachen" - `businessPartner.identifiers.issuingBody.name` (string) Preferred display label for an Issuing Body. Example: "Amtsgericht Aachen" - `businessPartner.legalForm` (object) Parameters for different kind of concept. - `businessPartner.addresses` (array) List of addresses of the Business Partner. - `businessPartner.addresses.thoroughfares` (array) List of thoroughfares. - `businessPartner.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" - `businessPartner.addresses.thoroughfares.number` (string) Number of the [Thoroughfare](https://meta.cdq.com/Address/thoroughfare). Example: "4" - `businessPartner.addresses.localities` (array) List of localities. - `businessPartner.addresses.administrativeAreas` (array) List of administrative areas. - `businessPartner.addresses.postCodes` (array) List of post codes. - `businessPartner.addresses.country` (object) Country consisting of the country name and country code (ISO 3166-1 alpha-2). - `businessPartner.addresses.country.shortName` (string) Country code (ISO 3166-1 alpha-2). Example: "CH" - `businessPartner.jsonRecord` (object) Business Partner of SAP ODM. - `businessPartner.jsonRecord.displayId` (string) Human-readable identifier. Example: "SAP" - `businessPartner.jsonRecord.businessPartnerType` (string) Type under which a business partner is classified (organization, person, or businessPartnerGroup). Example: "organization" - `businessPartner.jsonRecord.organization` (object) Details of an organization. - `businessPartner.jsonRecord.organization.nameDetails` (object) Scripted name of an organization. - `businessPartner.jsonRecord.organization.nameDetails.formattedOrgNameLine1` (string) Formatted organizational name line 1. Example: "SAP SE" - `businessPartner.jsonRecord.organization.nameDetails.formattedOrgNameLine2` (string) Formatted organizational name line 2. Example: "Hasso-Plattner-Ring 7" - `businessPartner.jsonRecord.organization.nameDetails.formattedOrgNameLine3` (string) Formatted organizational name line 3. Example: "69190 Walldorf" - `businessPartner.jsonRecord.organization.nameDetails.formattedOrgNameLine4` (string) Formatted organizational name line 4. Example: "Germany" - `businessPartner.jsonRecord.organization.nameDetails.formattedOrgName` (string) Fully formatted organization name. Example: "SAP SE, Hasso-Plattner-Ring 7, 69190 Walldorf, Germany" - `businessPartner.jsonRecord.organization.nameDetails.customSalutation` (string) A customizable, more informal salutation. Example: "Additional information" - `businessPartner.jsonRecord.organization.nameDetails.scriptVariants` (array) Scripted variants of an organization's name. - `businessPartner.jsonRecord.organization.nameDetails.scriptVariants.scriptCode` (object) Script code of the organization name. - `businessPartner.jsonRecord.organization.nameDetails.scriptVariants.scriptCode.name` (string) User-facing name of a code list entry. Example: "Code list entry name." - `businessPartner.jsonRecord.organization.nameDetails.scriptVariants.scriptCode.code` (string) The script code (language sign). Example: "Latn" - `businessPartner.jsonRecord.organization.legalForm` (object) Code for the legal form of a company. - `businessPartner.jsonRecord.organization.legalForm.code` (string) Code list entry. Example: "AG" - `businessPartner.jsonRecord.organization.globalLocationNumber` (string) The Global Location Number (GLN) - former Internal Location Number (ILN) - assigned by GS1 organizations identifies physical locations or legal entities uniquely. Example: "0847976000005" - `businessPartner.jsonRecord.identifications` (array) Proof of identity. - `businessPartner.jsonRecord.identifications.identificationType` (object) A code that represents the type of identification (such as an ID card, driver's license or commercial registry) for a business partner. - `businessPartner.jsonRecord.identifications.identificationNumber` (string) Number that identifies a business partner, such as a driver's license, or ID card number. Example: "DE123456789" - `businessPartner.jsonRecord.identifications.country` (object) A code that represents the country in which an ID number was assigned, or in which the number is valid (ISO 3166-1 code). - `businessPartner.jsonRecord.identifications.country.code` (string) The ISO-3166 2-char code of the country. Example: "DE" - `businessPartner.jsonRecord.identifications.region` (object) A code that represents the region in which an ID number was assigned, or in which the number is valid (ISO 3166-1 code, separator, ISO 3166-2 code). - `businessPartner.jsonRecord.identifications.region.code` (string) Country subdivision code. Example: "DE-BW" - `businessPartner.jsonRecord.identifications.institute` (string) Institution that administers or assigns an ID number. Example: "Federal Republic of Germany" - `businessPartner.jsonRecord.taxNumbers` (array) Tax numbers of the business partner. - `businessPartner.jsonRecord.taxNumbers.taxNumberType` (object) A code that specifies the tax number type. - `businessPartner.jsonRecord.taxNumbers.taxNumber` (string) Specifies the tax number. Example: "DE123456789" - `businessPartner.jsonRecord.addressData` (array) The address information of the business partner. - `businessPartner.jsonRecord.addressData.validFrom` (string) Begin date of validity period (ISO 8601 compliant). Example: "2025-08-27T14:27:23Z" - `businessPartner.jsonRecord.addressData.validTo` (string) End date of validity period (ISO 8601 compliant). Example: "2025-08-27T14:27:23Z" - `businessPartner.jsonRecord.addressData.usages` (array) Usage about the address information that is assigned to a business partner. - `businessPartner.jsonRecord.addressData.usages.usage` (object) A code that represents the usage for the address of the business partner. - `businessPartner.jsonRecord.addressData.usages.isStandard` (boolean) Establishes the usage of the address information is standard. Example: "true" - `businessPartner.jsonRecord.addressData.postalAddressType` (string) Defines if the address is for a person or an organization. Enum: "organizationPostalAddress", "personPostalAddress" - `businessPartner.jsonRecord.addressData.organizationPostalAddress` (object) Postal address that is assigned if the address type is "organizationPostalAddress". The address can appear in different scripts. Organization details are only maintained if they differ from the details of the business partner. - `businessPartner.jsonRecord.addressData.organizationPostalAddress.streetPrefix1` (string) Defines first line of the street print layout. Example: "StreetPrefix1" - `businessPartner.jsonRecord.addressData.organizationPostalAddress.streetPrefix2` (string) Defines second line of the street print layout. Example: "StreetPrefix1" - `businessPartner.jsonRecord.addressData.organizationPostalAddress.street` (object) Paired {name,code} type. - `businessPartner.jsonRecord.addressData.organizationPostalAddress.street.name` (string) Name of a street. Example: "Main Street" - `businessPartner.jsonRecord.addressData.organizationPostalAddress.street.ref` (object) Code of a street. - `businessPartner.jsonRecord.addressData.organizationPostalAddress.street.ref.code` (string) Street code. Example: "101" - `businessPartner.jsonRecord.addressData.organizationPostalAddress.streetSuffix1` (string) Defines before-last line of the street print layout. Example: "StreetSuffix1" - `businessPartner.jsonRecord.addressData.organizationPostalAddress.streetSuffix2` (string) Defines last line of the street print layout. Example: "StreetSuffix2" - `businessPartner.jsonRecord.addressData.organizationPostalAddress.houseNumber` (string) Building information. Example: "Building 1" - `businessPartner.jsonRecord.addressData.organizationPostalAddress.houseNumberSupplement` (string) Additional information. Example: "2nd floor" - `businessPartner.jsonRecord.addressData.organizationPostalAddress.building` (string) Building information. Example: "Building 1" - `businessPartner.jsonRecord.addressData.organizationPostalAddress.floor` (string) Floor information. Example: "2nd floor" - `businessPartner.jsonRecord.addressData.organizationPostalAddress.door` (string) Room, apartment, ... Example: "Room 14" - `businessPartner.jsonRecord.addressData.organizationPostalAddress.careOf` (string) A care of (c/o) party name. Example: "c/o John Doe" - `businessPartner.jsonRecord.addressData.organizationPostalAddress.primaryRegion` (object) Code list with codes that are _derived_ from subdivisions. A region for postal must provide a disjoint cut, in ISO 3166-2 it is not always the case (e.g. France 14 provinces, 95 departments, departments intersect with provinces). This means that additional work must be invested in curation of ISO 3166-2 code lists. So, while formally it the field type is ISO subdivision code, in fact it is a curated subset of ISO 3166-2, prepared for use in postal delivery. - `businessPartner.jsonRecord.addressData.organizationPostalAddress.secondaryRegion` (object) Locally governed region name second level, optionally code-list item. - `businessPartner.jsonRecord.addressData.organizationPostalAddress.secondaryRegion.name` (string) Name of a secondary region. Example: "Montgomery County" - `businessPartner.jsonRecord.addressData.organizationPostalAddress.secondaryRegion.ref` (object) Code of a secondary region. - `businessPartner.jsonRecord.addressData.organizationPostalAddress.secondaryRegion.ref.code` (string) Secondary region code. Example: "091" - `businessPartner.jsonRecord.addressData.organizationPostalAddress.tertiaryRegion` (object) Locally governed region name third level (e.g. Russia), optionally code-list item. - `businessPartner.jsonRecord.addressData.organizationPostalAddress.tertiaryRegion.name` (string) Name of a tertiary region. Example: "Montgomery County" - `businessPartner.jsonRecord.addressData.organizationPostalAddress.town` (object) City, town, village; a value from a code-list for towns; see ISO 19160-4 definition. - `businessPartner.jsonRecord.addressData.organizationPostalAddress.town.name` (string) Name of a town. Example: "Berlin" - `businessPartner.jsonRecord.addressData.organizationPostalAddress.town.ref` (object) Code of a town. - `businessPartner.jsonRecord.addressData.organizationPostalAddress.town.ref.code` (string) Town code. Example: "9000" - `businessPartner.jsonRecord.addressData.organizationPostalAddress.district` (object) An addressable area inside a town; see ISO 19160-4 definition: optional. - `businessPartner.jsonRecord.addressData.organizationPostalAddress.district.name` (string) Name of a district. Example: "Mitte" - `businessPartner.jsonRecord.addressData.organizationPostalAddress.country` (object) A value from a code-list for countries. - `businessPartner.jsonRecord.addressData.organizationPostalAddress.postCode` (string) Postal code (or Zip Code in the US, PLZ in Germany etc.). Example: "10115" - `businessPartner.jsonRecord.addressData.organizationPostalAddress.alternative` (object) Another type of address (e.g. service point delivery like PO box). - `businessPartner.jsonRecord.addressData.organizationPostalAddress.alternative.deliveryType` (object) A code-list containing a discriminator to select between address types. - `businessPartner.jsonRecord.addressData.organizationPostalAddress.alternative.deliveryType.code` (string) The code. Example: "POBOX" - `businessPartner.jsonRecord.addressData.organizationPostalAddress.alternative.deliveryServiceType` (string) A code-list containing a discriminator to select between address types. Enum: "POBoxDelivery", "PrivateBagDelivery", "PosteRestanteDelivery", "CompanyDelivery", "WorkerCampElectricityMeterDelivery", "WorkerCampBedDelivery", "Other" - `businessPartner.jsonRecord.addressData.organizationPostalAddress.alternative.deliveryServiceQualifier` (string) Needed as the same service identifier is only unique within the scope of the qualifier (i.e. same identifier could be used in different Post offices in the same town). Example: "Post Office SouthEast" - `businessPartner.jsonRecord.addressData.organizationPostalAddress.alternative.deliveryServiceIdentifier` (string) Identifier of the delivery service, e.g., the number of the PO Box. Unique within the scope of the deliveryServiceQualifier. Example: "1234" - `businessPartner.jsonRecord.addressData.organizationPostalAddress.coordinates` (object) The address as geo coordinates. - `businessPartner.jsonRecord.addressData.organizationPostalAddress.coordinates.latitude` (number) Latitude value of the coordinates. Example: "52.520008" - `businessPartner.jsonRecord.addressData.organizationPostalAddress.coordinates.longitude` (number) Longitude value of the coordinates. Example: "13.404954" - `businessPartner.jsonRecord.addressData.organizationPostalAddress.coordinates.altitude` (number) Altitude value of the coordinates. Example: "34.0" - `businessPartner.jsonRecord.addressData.organizationPostalAddress.scriptVariants` (array) Scripted variants of the organization's address. - `businessPartner.jsonRecord.addressData.organizationPostalAddress.scriptVariants.scriptCode` (object) Script code of the name of the organization address information. - `businessPartner.jsonRecord.addressData.emailAddresses` (object) Email addresses of the business partner. - `businessPartner.jsonRecord.addressData.emailAddresses.address` (string) The email address. Assumption: to be able to process special characters in the address all connected systems must be unicode enabled. EmailAddress according to external standard IETF RFC 5321. Example: "developer-portal@cdq.com" - `businessPartner.jsonRecord.addressData.websites` (object) Websites of the business partner. - `businessPartner.jsonRecord.addressData.websites.url` (string) The URL path for the website. Example: "https://www.developer.cdq.com" - `businessPartner.bankAccounts` (array) List of bank accounts of the Business Partner. - `businessPartner.bankAccounts.bankAccountIdentifier` (string) Identifier of a bank account in a national or international context. Example: "CH8800781619278412000" - `configurationId` (string) Configuration ID used to set up lookup. If provided, those parameters will be affected. If any of them is provided in this request, will overwrite one from configuration (except for features which are merged): * * * * * (deprecated) * * * Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4" ## Response 200 fields (application/json): - `total` (integer) Total number of items which can be paged. Example: "67" - `limit` (integer) Number of items per page. Example: "100" - `startAfter` (string) The ID which is used to read the page. Example: "5712566172571652" - `nextStartAfter` (string) Provides a value to be used as a startAfter in next page request. Example: "5712566172571652" - `values` (array) List of Business Partner Lookup Matches. - `values.cdqId` (string) Unique identifier for the Business Partner. Example: "VIES:PL8660001429" - `values.dataSource` (string) Unique identifier for a Data Source of the Storage. Example: "648824a691d8d2503d65103e" - `values.dataSourceName` (string) Name of a data source of a storage. Example: "Internal customers" - `values.storageDataSource` (object) This field allows to filter data mirrors that will be queried. For each data mirror, data sources can also be filtered. Leave empty to include all available data mirrors in query. - `values.storageDataSource.id` (string) ID of data mirror to be included during lookup. Example: "6479fd136811f0361e083211" - `values.lastSyncAt` (string) Date of last synchronization. Example: "2025-08-27T14:27:22Z" - `values.lastUpdatedAt` (string) Date of last business partner modification. Example: "2025-08-27T14:27:22Z" - `values.subscriptionMetadata` (object) Metadata of a subscription. - `values.subscriptionMetadata.subscribed` (boolean) Indicates if the subscription is subscribed. Example: "true" - `values.subscriptionMetadata.numberOfSubscribers` (integer) Number of subscribers. Example: "50" - `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. It can be , or . - `values.matchingProfile.matchingScores.overall.classification.technicalKey` (string) Technical key of the Matching Classification. Example: "HIGH" - `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.businessPartner` (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. - `values.businessPartner` (object) Refers to an organizational entity engaged in various facets of another organization's business interactions. This collaborative connection often manifests as a customer, supplier, vendor, or service provider. In the CDQ (Corporate Data Quality) framework, the Business Partner assumes a pivotal role as a core managed entity. Each Business Partner is distinctly and globally identifiable through a unique CDQ ID. All pertinent information, including addresses, identifiers, and hierarchical data, is intricately associated with and linked to the specific Business Partner, ensuring comprehensive management and traceability within the system. - `values.businessPartner.names` (array) List of names of the Business Partner. - `values.businessPartner.names.shortName` (string) The abbreviated variant of a company's full name. Example: "CDQ AG" - `values.businessPartner.names.type` (object) The type of the name, e.g. a locally used name or an international version. Allowed types are documented [here](https://meta.cdq.com/Business_partner/name/type). - `values.businessPartner.names.type.url` (string) URL to the documentation which summarizes all details of the [Name Type](https://meta.cdq.com/Business_partner/name/type). Example: "https://meta.cdq.com/Business_partner/name/type" - `values.businessPartner.names.type.name` (string) Display label for the Name Type. Example: "Local Name" - `values.businessPartner.names.type.technicalKey` (string) Technical Keys of the Name Type. Example: "LOCAL" - `values.businessPartner.names.value` (string) The actual name. Example: "Corporate Data Quality AG" - `values.businessPartner.names.language` (object) Naming of a language according to ISO 639-1. - `values.businessPartner.names.language.name` (string) ISO 639-1 name of language. Example: "German" - `values.businessPartner.names.language.technicalKey` (string) ISO 639-1 two-letter code of languages. Example: "DE" - `values.businessPartner.legalForm` (object) The legal form of a [Business Partner/type/legal entity](https://meta.cdq.com/Business_partner/type/legal_entity) is the form it takes in the eyes of the law governing it. The legal form of a [company](https://meta.cdq.com/Business_partner) is the general type it may legally use to identify itself according to the local, regional, national, or international law governing it. This is normally reflected in the ending abbreviation after the [company](https://meta.cdq.com/Business_partner)'s name (e.g. AG, Inc., LLC, S.A.). - `values.businessPartner.legalForm.name` (string) Display of the Legal Form. Example: "Aktiengesellschaft" - `values.businessPartner.legalForm.url` (string) URL to the documentation which summarizes all details of [Legal Form](https://meta.cdq.com/Business_partner/legal_form). Example: "https://meta.cdq.com/Business_partner/legal_form" - `values.businessPartner.legalForm.mainAbbreviation` (string) The primary abbreviation of a legal form, i.e. the most commonly used abbreviation in a country. Example: "AG" - `values.businessPartner.legalForm.categories` (array) List of categories of the legal form. - `values.businessPartner.legalForm.categories.name` (string) Descriptive display name of the Legal Form Category. Example: "Limited Liability Company" - `values.businessPartner.legalForm.categories.shortName` (string) Short display name of the Legal Form Category. Example: "LLC" - `values.businessPartner.legalForm.categories.url` (string) URL to the documentation which summarizes all details of the [Legal Form Category](https://meta.cdq.com/Business_partner/legal_form/category). Example: "https://meta.cdq.com/Business_partner/legal_form/category/technical_key/LF001" - `values.businessPartner.legalForm.categories.technicalKey` (string) Technical Key of the [Legal Form Category](https://meta.cdq.com/Business_partner/legal_form/category). Example: "LIMITED" - `values.businessPartner.legalForm.technicalKey` (string) Technical Key of a Legal Form. Descriptions of below enums contain , and . Example: "DE_9866" - `values.businessPartner.legalForm.cdlElfCode` (string) An unique identifier for CDL managed Legal Forms. Example: "AG" - `values.businessPartner.identifiers` (array) List of identifiers of the Business Partner. - `values.businessPartner.identifiers.type` (object) Value of the identifier. Allowed types are documented [here](https://meta.cdq.com/Category:Business_partner/identifier/type). - `values.businessPartner.identifiers.type.url` (string) URL to the documentation which summarizes all details of an [Identifier](https://meta.cdq.com/Business_partner/identifier/type). Example: "https://meta.cdq.com/Business_partner/identifier/type" - `values.businessPartner.identifiers.type.name` (string) Display label for the Identifier. Example: "CH_VAT_ID" - `values.businessPartner.identifiers.type.technicalKey` (string) Technical key of the type of the Identifier. Example: "CH_VAT_ID" - `values.businessPartner.identifiers.value` (string) Value of the identifier. Example: "CHE-218.608.886 HR/MWST" - `values.businessPartner.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.businessPartner.identifiers.issuingBody.shortName` (string) Preferred short display label for an Issuing Body. Example: "Amtsgericht Aachen" - `values.businessPartner.identifiers.issuingBody.name` (string) Preferred display label for an Issuing Body. Example: "Amtsgericht Aachen" - `values.businessPartner.identifiers.issuingBody.names` (array) List of names of the Issuing Body. - `values.businessPartner.identifiers.issuingBody.names.type` (object) The type of the name, e.g. a locally used name or an international version. - `values.businessPartner.identifiers.issuingBody.url` (string) URL to the documentation which summarizes all details of a [Issuing Body](https://meta.cdq.com/Business_partner/identifier/issuing_body). Example: "https://meta.cdq.com/Business_partner/identifier/issuing_body" - `values.businessPartner.identifiers.issuingBody.technicalKey` (string) Technical key of the Issuing Body. Example: "Amtsgericht Aachen" - `values.businessPartner.identifiers.issuingBody.jurisdiction` (object) The authority of an official organization to make decisions and judgments in a particular administrative area. - `values.businessPartner.identifiers.issuingBody.jurisdiction.country` (object) Country consisting of the country name and country code (ISO 3166-1 alpha-2). - `values.businessPartner.identifiers.issuingBody.jurisdiction.country.shortName` (string) Country code (ISO 3166-1 alpha-2). Example: "CH" - `values.businessPartner.identifiers.issuingBody.jurisdiction.country.value` (string) Country name (ISO 3166-1 alpha-2). Example: "Switzerland" - `values.businessPartner.identifiers.issuingBody.jurisdiction.administrativeAreas` (array) List of administrative areas in the jurisdiction. Example: ["Sankt Gallen"] - `values.businessPartner.identifiers.issuingBody.jurisdiction.administrativeAreas.value` (string) Name of the [Administrative Area](https://meta.cdq.com/Address/administrative_area). Example: "Sankt Gallen" - `values.businessPartner.identifiers.issuingBody.jurisdiction.administrativeAreas.shortName` (string) Abbreviation for the [Administrative Area](https://meta.cdq.com/Address/administrative_area). Example: "SG" - `values.businessPartner.identifiers.issuingBody.jurisdiction.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.businessPartner.identifiers.issuingBody.jurisdiction.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.businessPartner.identifiers.issuingBody.jurisdiction.administrativeAreas.type` (object) Type of the [Administrative Area](https://meta.cdq.com/Address/administrative_area). - `values.businessPartner.identifiers.issuingBody.jurisdiction.administrativeAreas.type.name` (string) Display label for the Administrative Area Type. Example: "COUNTY" - `values.businessPartner.identifiers.issuingBody.jurisdiction.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.businessPartner.identifiers.issuingBody.jurisdiction.administrativeAreas.type.technicalKey` (string) Technical key of the Administrative Area. Example: "COUNTY" - `values.businessPartner.identifiers.status` (object) Identifier Status refers to the current state of a unique identification number. - `values.businessPartner.identifiers.status.name` (string) Display label for the Identifier Status Name. Example: "ACTIVE" - `values.businessPartner.identifiers.status.technicalKey` (string) Technical key of the Identifier Status. Example: "ACTIVE" - `values.businessPartner.categories` (array) List of categories of the Business Partner. - `values.businessPartner.categories.name` (string) Display name of the Business Partner Category Name. Example: "Hotel" - `values.businessPartner.categories.url` (string) URL to the documentation which summarizes all details of the [Business Partner Category](https://meta.cdq.com/Business_partner/category). Example: "https://meta.cdq.com/Business_partner/category" - `values.businessPartner.categories.technicalKey` (string) Technical Key of the Business Partner Category. Example: "HOTEL" - `values.businessPartner.status` (object) Describes the status of a business partner with respect to its level of activity (e.g. out of business) or legally relevant conditions (e.g. in liquidation). - `values.businessPartner.status.officialDenotation` (string) The status as provided by an official register. Example: "Good Standing" - `values.businessPartner.status.validFrom` (string) Describes since when a business partner turned or will turn into the provided status. If no official date is known, the date of changing the status in the CDQ Community Data Pool or an external data source is provided. Example: "2025-08-27T14:27:22Z" - `values.businessPartner.status.validUntil` (string) Describes until when a business partner had a certain status. If no official date is known, the date of changing the status in the CDQ Community Data Pool or an external data source is provided. Example: "2025-08-27T14:27:22Z" - `values.businessPartner.status.type` (object) The standardized status which the business partner currently has. - `values.businessPartner.status.type.name` (string) Display name of the Business Partner Status. Example: "In Liquidation" - `values.businessPartner.status.type.url` (string) URL to the documentation which summarizes all details of the [Business Partner Status](https://meta.cdq.com/Business_partner/status/type). Example: "https://meta.cdq.com/Business_partner/status/type" - `values.businessPartner.status.type.technicalKey` (string) Technical Key of the Business Parter Status. Example: "IN_LIQUIDATION" - `values.businessPartner.addresses` (array) List of addresses of the Business Partner. - `values.businessPartner.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.businessPartner.addresses.version.characterSet` (object) Collection of [characters](https://meta.cdq.com/Address/version/character_set) that can be used to represent and manipulate textual data. - `values.businessPartner.addresses.version.characterSet.name` (string) Name of character set. Supported character sets can be found [here](https://meta.cdq.com/Address/version/character_set). Example: "International" - `values.businessPartner.addresses.version.characterSet.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.businessPartner.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.businessPartner.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.businessPartner.addresses.externalId` (string) ID the address has in the external system where the record originates from. Example: "1" - `values.businessPartner.addresses.metadata` (object) Specifies the language and primary data provenance. - `values.businessPartner.addresses.metadata.primaryProvenance` (object) The source of the change/update. Could be the reference data source as VIES or Organization. - `values.businessPartner.addresses.metadata.primaryProvenance.name` (string) Display Name of the Provenance Name. Example: "VIES" - `values.businessPartner.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.businessPartner.addresses.metadata.primaryProvenance.technicalKey` (string) Technical Key of the Provenance Name. Example: "VIES" - `values.businessPartner.addresses.metadata.primaryProvenance.cdqId` (string) The ID provided for a linkage with the source by CDQ. Example: "VIES:PL8660001429" - `values.businessPartner.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.businessPartner.addresses.careOf.value` (string) Value of the CareOf. Example: "CDQ GmbH c/o Product Department" - `values.businessPartner.addresses.contexts` (array) List of address contexts. - `values.businessPartner.addresses.contexts.value` (string) Value of the Address Context. Example: "Production hall 7, Storage field 8." - `values.businessPartner.addresses.administrativeAreas` (array) List of administrative areas. Example: ["Sankt Gallen"] - `values.businessPartner.addresses.postCodes` (array) List of post codes. - `values.businessPartner.addresses.postCodes.value` (string) Effective [post code](https://meta.cdq.com/Address/post_code). Example: "9000" - `values.businessPartner.addresses.postCodes.type` (object) Type of the Post Code. - `values.businessPartner.addresses.postCodes.type.name` (string) Display label for the Post Code Type. Example: "Regular" - `values.businessPartner.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.businessPartner.addresses.postCodes.type.technicalKey` (string) Technical key of the Post Code. Example: "REGULAR" - `values.businessPartner.addresses.localities` (array) List of localities. - `values.businessPartner.addresses.localities.type` (object) Type of the [Locality](https://meta.cdq.com/Address/locality). - `values.businessPartner.addresses.localities.type.name` (string) Display label for the Locality Type. Example: "City" - `values.businessPartner.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.businessPartner.addresses.localities.type.technicalKey` (string) Technical Key of the Locality Type. Example: "CITY" - `values.businessPartner.addresses.localities.shortName` (string) Abbreviation of the [Locality](https://meta.cdq.com/Address/locality). Example: "St. Gallen" - `values.businessPartner.addresses.localities.value` (string) Name of the [Locality](https://meta.cdq.com/Address/locality). Example: "Sankt Gallen" - `values.businessPartner.addresses.thoroughfares` (array) List of thoroughfares. - `values.businessPartner.addresses.thoroughfares.type` (object) Type of the [Thoroughfare](https://meta.cdq.com/Address/thoroughfare). - `values.businessPartner.addresses.thoroughfares.type.name` (string) Display label for the Thoroughfare Type Name. Example: "Industrial zone" - `values.businessPartner.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.businessPartner.addresses.thoroughfares.type.technicalKey` (string) Technical key of the Thoroughfare Type. Example: "INDUSTRIAL_ZONE" - `values.businessPartner.addresses.thoroughfares.shortName` (string) Abbreviation of the [Thoroughfare](https://meta.cdq.com/Address/thoroughfare). Example: "Lukasstr. 4" - `values.businessPartner.addresses.thoroughfares.number` (string) Number of the [Thoroughfare](https://meta.cdq.com/Address/thoroughfare). Example: "4" - `values.businessPartner.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.businessPartner.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.businessPartner.addresses.thoroughfares.direction` (string) Direction of the [Thoroughfare](https://meta.cdq.com/Address/thoroughfare). Example: "221-bis Baker Street, North" - `values.businessPartner.addresses.premises` (array) List of premises. - `values.businessPartner.addresses.premises.value` (string) The actual value of a Premise in the language of the address. Example: "Lukasstraße 4" - `values.businessPartner.addresses.premises.shortName` (string) Abbreviation of the Premise. Example: "Lukasstr. 4" - `values.businessPartner.addresses.premises.number` (string) Number of the Premise. Example: "4" - `values.businessPartner.addresses.premises.type` (object) Type of the Premise. - `values.businessPartner.addresses.premises.type.name` (string) Display label for the Premise Type. Example: "Factory" - `values.businessPartner.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.businessPartner.addresses.premises.type.technicalKey` (string) Technical key of the Premise Type. Example: "FACTORY" - `values.businessPartner.addresses.postalDeliveryPoints` (array) List of postal delivery points. - `values.businessPartner.addresses.postalDeliveryPoints.type` (object) A single mailbox or other place at which postal mail is delivered. - `values.businessPartner.addresses.postalDeliveryPoints.type.name` (string) Display label for the Postal Delivery Point Type. Example: "Mailbox" - `values.businessPartner.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.businessPartner.addresses.postalDeliveryPoints.type.technicalKey` (string) Technical key of the Postal Delivery Point. Example: "MAILBOX" - `values.businessPartner.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.businessPartner.addresses.postalDeliveryPoints.number` (string) Number of the [Postal Delivery Point](https://meta.cdq.com/Address/postal_delivery_point). Example: "460" - `values.businessPartner.addresses.postalDeliveryPoints.value` (string) Value of the [Postal Delivery Point](https://meta.cdq.com/Address/postal_delivery_point). Example: "Postfach" - `values.businessPartner.addresses.geographicCoordinates` (object) Decimal geographic coordinates (WGS 84 - reference coordinate system). - `values.businessPartner.addresses.geographicCoordinates.latitude` (number) Plain on the earth's surface north or south of the equator. Example: "47.439549" - `values.businessPartner.addresses.geographicCoordinates.longitude` (number) Plain on the earth's surface east or west of a meridian. Example: "9.395275" - `values.businessPartner.addresses.types` (array) List of address types. - `values.businessPartner.addresses.types.name` (string) Display label for the Address Type. Example: "Legal Address" - `values.businessPartner.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.businessPartner.addresses.types.technicalKey` (string) Technical key of the Address Type. Example: "LEGAL_ADDRESS" - `values.businessPartner.addresses.formattedAddress` (object) A formatted address is a structured address of VIES data source. - `values.businessPartner.addresses.formattedAddress.country` (string) Country name. Example: "Switzerland" - `values.businessPartner.addresses.formattedAddress.administrativeArea` (string) A top-level geographical or political area division in a country. Example: "Sankt Gallen" - `values.businessPartner.addresses.formattedAddress.region` (string) Top level subdivision of a country. Example: "Sankt Gallen" - `values.businessPartner.addresses.formattedAddress.regionCode` (string) A country specific code for a certain address in the region. Example: "9004" - `values.businessPartner.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.businessPartner.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.businessPartner.addresses.formattedAddress.postalCode` (string) A country specific code for a certain address. Example: "9000" - `values.businessPartner.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.businessPartner.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.businessPartner.addresses.formattedAddress.interurbanDeliveryPoint` (string) A single mailbox or other place at which postal mail is delivered. Example: "Sankt Gallen, Postfach 460" - `values.businessPartner.addresses.formattedAddress.mailbox` (string) A location at an address where the post is delivered to. Example: "Postfach 460" - `values.businessPartner.addresses.formattedAddress.postOfficeBox` (string) A uniquely addressable lockable box located on the premises of a post office station. Example: "Postfach 460" - `values.businessPartner.externalId` (string) Arbitrary identifier type to mark customer IDs that are "external" from CDQ's perspective. This is the identifier a customer provides to identify its records. Example: "The ID managed in the customer's SAP systems." - `values.businessPartner.profile` (object) A Business Partner [profile](https://meta.cdq.com/Partner_profile) contains important information about a company, such as its classification, tags, contact details, or minority indicator. - `values.businessPartner.profile.minorityIndicator` (object) The minority indicator determines the minority group to which a vendor belongs. Usually, the minority indicator is only relevant in the United States and it is used for reporting purposes only. There is a corresponding SAP field in the vendor master for maintaining the minority indicator. This feature is as of today dependent on data provided by a US based company: SupplierGateway. Additional documentation can be found [here](https://meta.cdq.com/Business_partner/partner_profile/minority_indicator). - `values.businessPartner.profile.minorityIndicator.value` (string) The actual value of the minority indicator, representing the minority group. Example: "Social enterprise" - `values.businessPartner.profile.classifications` (array) List of classifications of the Business Partner. - `values.businessPartner.profile.classifications.value` (string) A textual description of the Classification. Example: "Manufacture of pesticides and other agrochemical products." - `values.businessPartner.profile.classifications.code` (string) Code that classifies the business partner. Example: "20.20Z" - `values.businessPartner.profile.classifications.type` (object) Type of classification such as NACE, SIC, NAF or other industry classification standards. - `values.businessPartner.profile.classifications.type.name` (string) Display label for the Classification Type. Example: "NAF 2003" - `values.businessPartner.profile.classifications.type.url` (string) URL to the documentation which summarizes all details of the [Classification Type](https://meta.cdq.com/Business_partner/partner_profile/classification/type) Example: "https://meta.cdq.com/Business_partner/partner_profile/classification/type" - `values.businessPartner.profile.phoneNumbers` (array) List of phone numbers of the Business Partner. - `values.businessPartner.profile.phoneNumbers.countryPrefix` (string) The country prefix of a phone number. Example: "+41" - `values.businessPartner.profile.phoneNumbers.number` (string) The complete phone number without any country prefixes. Example: "71 571 10 40" - `values.businessPartner.profile.phoneNumbers.type` (object) The [type](https://meta.cdq.com/Business_partner/partner_profile/phone_number/type) of phone number such as mobile phone or fixed line. - `values.businessPartner.profile.phoneNumbers.type.name` (string) Display label for a Phone Number Type Name. Example: "FAX" - `values.businessPartner.profile.phoneNumbers.type.url` (string) URL to the documentation which summarizes all details of the [Phone Number Type](https://meta.cdq.com/Business_partner/partner_profile/phone_number/type). Example: "https://meta.cdq.com/Business_partner/partner_profile/phone_number/type" - `values.businessPartner.profile.phoneNumbers.value` (string) The actual complete phone number incl. country prefix. Example: "+41 71 571 10 40" - `values.businessPartner.profile.websites` (array) List of websites of the Business Partner. - `values.businessPartner.profile.websites.url` (string) The actual company website URL. Example: "https://cdq.com" - `values.businessPartner.profile.websites.type` (object) Describes the type of website of a business partner, e.g. corporate website, official LinkedIn profile, etc. - `values.businessPartner.profile.websites.type.name` (string) Display label for a Website Type Name Example: "Corporate Website" - `values.businessPartner.profile.websites.type.url` (string) URL to the documentation which summarizes [Website Type Name](https://meta.cdq.com/Business_Partner/partner_profile/website/type). Example: "https://meta.cdq.com/Business_Partner/partner_profile/website/type" - `values.businessPartner.profile.websites.type.technicalKey` (string) Technical Keys of the Website Type Name. Example: "WEBSITE_TYPE_CORPORATE" - `values.businessPartner.profile.contactEmails` (array) List of contact emails of the Business Partner. - `values.businessPartner.profile.contactEmails.value` (string) Value of the email address of the Business Partner. Example: "developer-portal@cdq.com" - `values.businessPartner.profile.tags` (array) List of Tags. - `values.businessPartner.profile.tags.value` (string) Value of the tag. Example: "Warehouse" - `values.businessPartner.profile.tags.type` (object) A type that specifies the nature of the tag. - `values.businessPartner.profile.tags.type.technicalKey` (string) Technical Key of the Tag. Example: "WAREHOUSE" - `values.businessPartner.profile.vatPayerStatus` (object) Information about VAT status including publication date and registration authority. - `values.businessPartner.profile.vatPayerStatus.publicationDate` (string) Date of publication Example: "2025-08-27T14:27:22Z" - `values.businessPartner.profile.vatPayerStatus.status` (object) Information about payer status. - `values.businessPartner.profile.vatPayerStatus.status.name` (string) Name of Vat payer status. Available values RELIABLE and UNRELIABLE Example: "RELIABLE" - `values.businessPartner.profile.vatPayerStatus.status.technicalKey` (string) Technical key of Vat payer status Example: "VAT_PAYER_STATUS" - `values.businessPartner.profile.vatPayerStatus.registrationAuthority` (object) Additional information about registration authority. - `values.businessPartner.profile.vatPayerStatus.registrationAuthority.registrationAuthorityId` (string) The reference code of the registration authority, taken from the Registration Authorities Code List maintained by GLEIF. Example: "RA000009" - `values.businessPartner.profile.vatPayerStatus.registrationAuthority.registrationAuthorityEntityId` (string) The identifier of the Entity at the indicated registration authority. Example: "RA000009" - `values.businessPartner.profile.vatPayerStatus.registrationAuthority.otherRegistrationAuthorityId` (string) A legacy / historical reference code of a registration authority. Example: "RA000009" - `values.businessPartner.profile.hcpProfile` (object) Healthcare Professional Profile informs about the status, licenses, and location of a natural person who is a member of the medical, dental, pharmacy, or nursing professions or any other person who, in the course of his/her professional activities, may prescribe, purchase, supply, recommend or administer a Medicinal Product and whose primary practice, principal professional address or place of incorporation is in Europe. - `values.businessPartner.profile.hcpProfile.generalLicense` (object) The general license of the Healthcare Professional. - `values.businessPartner.profile.hcpProfile.generalLicense.professionType` (object) The profession type of the Healthcare Professional. - `values.businessPartner.profile.hcpProfile.generalLicense.professionType.name` (string) Name of the profession type. Example: "Doctor" - `values.businessPartner.profile.hcpProfile.generalLicense.professionType.url` (string) URL to the documentation of the Profession Type Technical Key. Example: "https://meta.cdq.com/Business_partner/partner_profile/hcp_profile/general_license/profession_type/technical_key" - `values.businessPartner.profile.hcpProfile.generalLicense.professionType.technicalKey` (string) Technical key of the profession type. Example: "DOCTOR" - `values.businessPartner.profile.hcpProfile.generalLicense.licenseStatus` (object) The license status of the Healthcare Professional. - `values.businessPartner.profile.hcpProfile.generalLicense.licenseStatus.name` (string) Name of the license status. Example: "Granted" - `values.businessPartner.profile.hcpProfile.generalLicense.licenseStatus.url` (string) URL to the documentation of the License Status Technical Key. Example: "https://meta.cdq.com/Business_partner/partner_profile/hcp_profile/general_license/license_status/technical_key" - `values.businessPartner.profile.hcpProfile.generalLicense.licenseStatus.technicalKey` (string) Technical key of the license status. Example: "GRANTED" - `values.businessPartner.profile.hcpProfile.operationalPermissions` (array) Operational permissions of the Healthcare Professional. - `values.businessPartner.profile.hcpProfile.operationalPermissions.issuingAuthority` (string) The issuing authority of the operational permission. Example: "Swiss Medical Association" - `values.businessPartner.profile.hcpProfile.operationalPermissions.permissionStatus` (object) The permission status of the operational permission. - `values.businessPartner.profile.hcpProfile.operationalPermissions.permissionStatus.name` (string) Name of the permission status. Example: "Granted" - `values.businessPartner.profile.hcpProfile.operationalPermissions.permissionStatus.url` (string) URL to the documentation of the Permission Status Technical Key. Example: "https://meta.cdq.com/Business_partner/partner_profile/hcp_profile/operational_permissions/permission_status/url" - `values.businessPartner.profile.hcpProfile.operationalPermissions.permissionStatus.technicalKey` (string) Technical key of the permission status. Example: "GRANTED" - `values.businessPartner.profile.hcpProfile.operationalPermissions.activityStatus` (object) The activity status of the operational permission. - `values.businessPartner.profile.hcpProfile.operationalPermissions.activityStatus.name` (string) Name of the activity status. Possible values: * Active - The operational permission is active. * Inactive - The operational permission is inactive. Example: "Inactive" - `values.businessPartner.profile.hcpProfile.operationalPermissions.activityStatus.url` (string) URL to the documentation of the Activity Status Technical Key. Example: "https://meta.cdq.com/Business_partner/partner_profile/hcp_profile/operational_permissions/activity_status/url" - `values.businessPartner.profile.hcpProfile.operationalPermissions.activityStatus.technicalKey` (string) Technical key of the activity status. Example: "INACTIVE" - `values.businessPartner.profile.hcpProfile.operationalPermissions.practiceLocations` (array) Practice locations of the Healthcare Professional. - `values.businessPartner.profile.hcpProfile.operationalPermissions.practiceLocations.practiceName` (string) The practice location of the Healthcare Professional. Example: "VIVOMED AG" - `values.businessPartner.profile.hcpProfile.operationalPermissions.practiceLocations.selfDispensationStatus` (object) The self-dispensation status of the Healthcare Professional. - `values.businessPartner.profile.hcpProfile.operationalPermissions.practiceLocations.selfDispensationStatus.name` (string) Name of the self-dispensation status. Example: "No" - `values.businessPartner.profile.hcpProfile.operationalPermissions.practiceLocations.selfDispensationStatus.url` (string) URL to the documentation of the Self Dispensation Status Technical Key. Example: "https://meta.cdq.com/Business_partner/partner_profile/hcp_profile/operational_permissions/self_dispensation_status/url" - `values.businessPartner.profile.hcpProfile.operationalPermissions.practiceLocations.selfDispensationStatus.technicalKey` (string) Technical key of the self-dispensation status. Example: "NO" - `values.businessPartner.profile.hcpProfile.operationalPermissions.practiceLocations.controlledSubstancePurchasePermission` (object) The controlled substance purchase permission of the Healthcare Professional. - `values.businessPartner.profile.hcpProfile.operationalPermissions.practiceLocations.controlledSubstancePurchasePermission.name` (string) Name of the controlled substance purchase permission. Example: "Yes" - `values.businessPartner.profile.hcpProfile.operationalPermissions.practiceLocations.controlledSubstancePurchasePermission.url` (string) URL to the documentation of the Controlled Substance Purchase Permission Technical Key. Example: "https://meta.cdq.com/Business_partner/partner_profile/hcp_profile/operational_permissions/controlled_substance_purchase_permission/url" - `values.businessPartner.profile.hcpProfile.operationalPermissions.practiceLocations.controlledSubstancePurchasePermission.technicalKey` (string) Technical key of the controlled substance purchase permission. Example: "YES" - `values.businessPartner.formattedSapRecord` (object) Provides business partner and address information in a data structure similar to SAP Business Partner table BUT000 and SAP Business Address Services table ADRC. Field names are equal or very similar to SAP field names in order to simplify field mapping. Data for name and street fields is already split into chunks of max. 35 characters. - `values.businessPartner.formattedSapRecord.name1` (string) A name1 filed of a business partner name. Example: "CDQ AG" - `values.businessPartner.formattedSapRecord.name2` (string) A name2 filed of a business partner name. Example: "CDQ AG" - `values.businessPartner.formattedSapRecord.name3` (string) A name3 filed of a business partner name. Example: "CDQ AG" - `values.businessPartner.formattedSapRecord.name4` (string) A name4 filed of a business partner name. Example: "CDQ AG" - `values.businessPartner.formattedSapRecord.nameCo` (string) The legal form name of a Legal Form. Example: "Aktiengesellschaft" - `values.businessPartner.formattedSapRecord.legalEntity` (string) The legal entity of a Legal Form. Example: "Aktiengesellschaft" - `values.businessPartner.formattedSapRecord.legalForm` (string) The legal form of a Legal Form. Example: "Aktiengesellschaft" - `values.businessPartner.formattedSapRecord.indSector` (string) A business industry or activity classification is a system of categorizing businesses and organizations into specific industries or activities based on their primary products or services, functions, or activities. These classifications are often used by governments, trade organizations, and other institutions to collect and analyze data on economic activity and to track trends and changes in various sectors. Example: "NAF" - `values.businessPartner.formattedSapRecord.indSectorCode` (string) A code of business industry or activity classification is a system of categorizing businesses and organizations into specific industries or activities based on their primary products or services, functions, or activities. These classifications are often used by governments, trade organizations, and other institutions to collect and analyze data on economic activity and to track trends and changes in various sectors. Example: "NAF" - `values.businessPartner.formattedSapRecord.emailAddress` (string) Email address of the Business Partner. Example: "bp@gmail.com" - `values.businessPartner.formattedSapRecord.narp` (string) An individual person, i.e. not an organization. An individual has no identifiers and has no legal form in its name. Example: "Friedrich Nietzsche" - `values.businessPartner.formattedSapRecord.stceg` (string) VAT registration number. Example: "CHE-218.608.88" - `values.businessPartner.formattedSapRecord.stcd1` (string) Standard tax number field1. Example: "CHE-218.608.88" - `values.businessPartner.formattedSapRecord.stcd2` (string) Standard tax number field2. Example: "CHE-218.608.88" - `values.businessPartner.formattedSapRecord.stcd3` (string) Standard tax number field3. Example: "CHE-218.608.88" - `values.businessPartner.formattedSapRecord.stcd4` (string) Standard tax number field4. Example: "CHE-218.608.88" - `values.businessPartner.formattedSapRecord.stcd5` (string) Standard tax number field5. Example: "CHE-218.608.88" - `values.businessPartner.formattedSapRecord.url` (string) Webpages related to the business partner, e.g. the main corporate website as also provided by some company registers. Example: "www.cdq.com" - `values.businessPartner.formattedSapRecord.telNumber` (string) The main phone number of a business partner, usually some info-line of the headquarter. Example: "+41 71 571 10 40" - `values.businessPartner.formattedSapRecord.countryCode` (string) Country code (ISO 3166-1 alpha-2) Example: "CH" - `values.businessPartner.formattedSapRecord.region` (string) A top-level geographical or political area division in a country. Example: "Sankt Gallen" - `values.businessPartner.formattedSapRecord.regionCodeSap` (string) A Region specific code for a certain address. Example: "9004" - `values.businessPartner.formattedSapRecord.county` (string) A sub-level geographical or political area division in a country. Example: "Sankt Gallen" - `values.businessPartner.formattedSapRecord.countyCode` (string) A county specific code for a certain address in the region. Example: "9004" - `values.businessPartner.formattedSapRecord.township` (string) A sub-level geographical or political area division in a country. Example: "Sankt Gallen" - `values.businessPartner.formattedSapRecord.townshipCode` (string) A township specific code for a certain address in the region. Example: "9004" - `values.businessPartner.formattedSapRecord.city` (string) A locality is a named densely populated area (a place) such as town, village, suburb, etc. A locality composes of many individual addresses. Many localities exist in an [administrative area](https://meta.cdq.com/Address/administrative_area). A locality can also have several levels of sub localities. Example: "Sankt Gallen" - `values.businessPartner.formattedSapRecord.district` (string) Area of a country or city. Example: "St. Georgen" - `values.businessPartner.formattedSapRecord.postalCode3` (string) A country specific code for a certain address. Example: "9000" - `values.businessPartner.formattedSapRecord.street1` (string) Details of the access route along which buildings, lots, or land are located, such as street, road, channel, crescent, avenue, etc. This also includes canals or banks on which houses or boat houses are located where people live. Example: "Lukasstraße 4" - `values.businessPartner.formattedSapRecord.street2` (string) Additional street filed. Example: "Lukasstraße 4" - `values.businessPartner.formattedSapRecord.street5` (string) Additional street filed. Example: "Lukasstraße 4" - `values.businessPartner.formattedSapRecord.houseNum` (string) Number of the Thoroughfare. Example: "4" - `values.businessPartner.formattedSapRecord.houseNum2` (string) Additional number filed. Example: "4" - `values.businessPartner.formattedSapRecord.building` (string) A structure (such as a house, hospital, school, etc.) with a roof and walls that is used as a place for people to live, work, do activities, store things, etc. Example: "Office 2" - `values.businessPartner.formattedSapRecord.floor` (string) The floor/story of the building. Example: "2" - `values.businessPartner.formattedSapRecord.roomnumber` (string) A distinct room in a building. Example: "123" - `values.businessPartner.formattedSapRecord.poBoxCountry` (string) A location at an address where the post is delivered to. Example: "9000" - `values.businessPartner.formattedSapRecord.poBoxCity` (string) A location at an address where the post is delivered to. Example: "9000" - `values.businessPartner.formattedSapRecord.poBoxPostalCode` (string) A location at an address where the post is delivered to. Example: "9000" - `values.businessPartner.formattedSapRecord.poBox` (string) Des Example: "9000" - `values.businessPartner.relations` (array) List of relations of the Business Partner. - `values.businessPartner.relations.startedAt` (string) Describe when this relationship was first established. Example: "2025-08-27T14:27:22Z" - `values.businessPartner.relations.endedAt` (string) Describe when this relationship ended. Example: "2025-08-27T14:27:22Z" - `values.businessPartner.relations.type` (object) Provides information about the type of the relationship between two Business Partners like:\ direct parent/child, ultimate parent, branch. - `values.businessPartner.relations.type.name` (string) Display name of the Business Partner Relation Type. Example: "Commercial ultimate" - `values.businessPartner.relations.type.url` (string) URL to the documentation which summarizes all details of a [Business Partner Relation Type](https://meta.cdq.com/Business_partner/relation/type). Example: "https://meta.cdq.com/Business_partner/relation/type" - `values.businessPartner.relations.type.technicalKey` (string) Technical Key of the Business Partner Relation Type. Example: "COMMERCIAL_ULTIMATE" - `values.businessPartner.relations.class` (object) Provides information about the classification of the relation. - `values.businessPartner.relations.class.name` (string) Display name of the Business Partner Relation Class. Example: "CDQ Hierarchy" - `values.businessPartner.relations.class.url` (string) URL to the documentation which summarizes all details of a [Business Partner Relation Class](https://meta.cdq.com/Business_partner/relation/class). Example: "https://meta.cdq.com/Business_partner/relation/class" - `values.businessPartner.relations.class.technicalKey` (string) Technical Key of the Business Partner Relation Class. Example: "BUSINESS_PARTNER_RELATION_CLASS_CDQ_HIERARCHY" - `values.businessPartner.relations.startNode` (string) It's a number of the business partner that plays a superior role over the other business partner. In means that, the company is parent of the second company (child) and has one of the relationship type like:\ Domestic Ultimate Legal entity or Direct Legal entity. Example: "FR.RC:5664645" - `values.businessPartner.relations.endNode` (string) It's a number of the business partner that plays a subordinate role over the other business partner. In means that, the company is chile of the second company (parent) and has one of the special relationship types. Example: "FR.RC:5664645" - `values.businessPartner.relations.startNodeBusinessPartner` (object) Relation of the Business Partner. - `values.businessPartner.relations.startNodeBusinessPartner.names` (array) List of names. - `values.businessPartner.relations.startNodeBusinessPartner.addresses` (array) List of addresses. - `values.businessPartner.relations.startNodeBusinessPartner.addresses.postCodes` (array) List of Post Codes. - `values.businessPartner.relations.startNodeBusinessPartner.addresses.localities` (array) List of Localities. - `values.businessPartner.relations.startNodeBusinessPartner.addresses.thoroughfares` (array) List of Thoroughfares. - `values.businessPartner.relations.endNodeBusinessPartner` (object) Relation of the Business Partner. - `values.businessPartner.types` (array) List of types of the Business Partner. - `values.businessPartner.types.name` (string) Display name of the Business Partner Type Name. Example: "Legal Entity" - `values.businessPartner.types.url` (string) URL to the documentation which summarizes all details of a [Buisness Partner Type](https://meta.cdq.com/Business_partner/type). Example: "https://meta.cdq.com/Business_partner/type" - `values.businessPartner.types.technicalKey` (string) Technical key of the Business Partner Type. Example: "LEGAL_ENTITY" - `values.businessPartner.externalContext` (object) Describe own identifiers of a record (others than just the external ID). - `values.businessPartner.externalContext.identifiers` (array) List of external context identifiers. - `values.businessPartner.externalContext.identifiers.value` (string) Value of own identifiers of a record. Example: "7250017031" - `values.businessPartner.externalContext.identifiers.type` (object) Type of own identifiers of a record. - `values.businessPartner.externalContext.identifiers.type.technicalKey` (string) Technical key for the External Context Identifier Type. Example: "KUNNR" - `values.businessPartner.jsonRecord` (object) Business Partner of SAP ODM. - `values.businessPartner.jsonRecord.displayId` (string) Human-readable identifier. Example: "SAP" - `values.businessPartner.jsonRecord.businessPartnerType` (string) Type under which a business partner is classified (organization, person, or businessPartnerGroup). Example: "organization" - `values.businessPartner.jsonRecord.organization` (object) Details of an organization. - `values.businessPartner.jsonRecord.organization.nameDetails` (object) Scripted name of an organization. - `values.businessPartner.jsonRecord.organization.nameDetails.formattedOrgNameLine1` (string) Formatted organizational name line 1. Example: "SAP SE" - `values.businessPartner.jsonRecord.organization.nameDetails.formattedOrgNameLine2` (string) Formatted organizational name line 2. Example: "Hasso-Plattner-Ring 7" - `values.businessPartner.jsonRecord.organization.nameDetails.formattedOrgNameLine3` (string) Formatted organizational name line 3. Example: "69190 Walldorf" - `values.businessPartner.jsonRecord.organization.nameDetails.formattedOrgNameLine4` (string) Formatted organizational name line 4. Example: "Germany" - `values.businessPartner.jsonRecord.organization.nameDetails.formattedOrgName` (string) Fully formatted organization name. Example: "SAP SE, Hasso-Plattner-Ring 7, 69190 Walldorf, Germany" - `values.businessPartner.jsonRecord.organization.nameDetails.customSalutation` (string) A customizable, more informal salutation. Example: "Additional information" - `values.businessPartner.jsonRecord.organization.nameDetails.scriptVariants` (array) Scripted variants of an organization's name. - `values.businessPartner.jsonRecord.organization.nameDetails.scriptVariants.scriptCode` (object) Script code of the organization name. - `values.businessPartner.jsonRecord.organization.nameDetails.scriptVariants.scriptCode.name` (string) User-facing name of a code list entry. Example: "Code list entry name." - `values.businessPartner.jsonRecord.organization.nameDetails.scriptVariants.scriptCode.code` (string) The script code (language sign). Example: "Latn" - `values.businessPartner.jsonRecord.organization.legalForm` (object) Code for the legal form of a company. - `values.businessPartner.jsonRecord.organization.legalForm.code` (string) Code list entry. Example: "AG" - `values.businessPartner.jsonRecord.organization.globalLocationNumber` (string) The Global Location Number (GLN) - former Internal Location Number (ILN) - assigned by GS1 organizations identifies physical locations or legal entities uniquely. Example: "0847976000005" - `values.businessPartner.jsonRecord.identifications` (array) Proof of identity. - `values.businessPartner.jsonRecord.identifications.identificationType` (object) A code that represents the type of identification (such as an ID card, driver's license or commercial registry) for a business partner. - `values.businessPartner.jsonRecord.identifications.identificationNumber` (string) Number that identifies a business partner, such as a driver's license, or ID card number. Example: "DE123456789" - `values.businessPartner.jsonRecord.identifications.country` (object) A code that represents the country in which an ID number was assigned, or in which the number is valid (ISO 3166-1 code). - `values.businessPartner.jsonRecord.identifications.country.code` (string) The ISO-3166 2-char code of the country. Example: "DE" - `values.businessPartner.jsonRecord.identifications.region` (object) A code that represents the region in which an ID number was assigned, or in which the number is valid (ISO 3166-1 code, separator, ISO 3166-2 code). - `values.businessPartner.jsonRecord.identifications.region.code` (string) Country subdivision code. Example: "DE-BW" - `values.businessPartner.jsonRecord.identifications.institute` (string) Institution that administers or assigns an ID number. Example: "Federal Republic of Germany" - `values.businessPartner.jsonRecord.taxNumbers` (array) Tax numbers of the business partner. - `values.businessPartner.jsonRecord.taxNumbers.taxNumberType` (object) A code that specifies the tax number type. - `values.businessPartner.jsonRecord.taxNumbers.taxNumber` (string) Specifies the tax number. Example: "DE123456789" - `values.businessPartner.jsonRecord.addressData` (array) The address information of the business partner. - `values.businessPartner.jsonRecord.addressData.validFrom` (string) Begin date of validity period (ISO 8601 compliant). Example: "2025-08-27T14:27:23Z" - `values.businessPartner.jsonRecord.addressData.validTo` (string) End date of validity period (ISO 8601 compliant). Example: "2025-08-27T14:27:23Z" - `values.businessPartner.jsonRecord.addressData.usages` (array) Usage about the address information that is assigned to a business partner. - `values.businessPartner.jsonRecord.addressData.usages.usage` (object) A code that represents the usage for the address of the business partner. - `values.businessPartner.jsonRecord.addressData.usages.isStandard` (boolean) Establishes the usage of the address information is standard. Example: "true" - `values.businessPartner.jsonRecord.addressData.postalAddressType` (string) Defines if the address is for a person or an organization. Enum: "organizationPostalAddress", "personPostalAddress" - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress` (object) Postal address that is assigned if the address type is "organizationPostalAddress". The address can appear in different scripts. Organization details are only maintained if they differ from the details of the business partner. - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.streetPrefix1` (string) Defines first line of the street print layout. Example: "StreetPrefix1" - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.streetPrefix2` (string) Defines second line of the street print layout. Example: "StreetPrefix1" - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.street` (object) Paired {name,code} type. - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.street.name` (string) Name of a street. Example: "Main Street" - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.street.ref` (object) Code of a street. - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.street.ref.code` (string) Street code. Example: "101" - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.streetSuffix1` (string) Defines before-last line of the street print layout. Example: "StreetSuffix1" - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.streetSuffix2` (string) Defines last line of the street print layout. Example: "StreetSuffix2" - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.houseNumber` (string) Building information. Example: "Building 1" - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.houseNumberSupplement` (string) Additional information. Example: "2nd floor" - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.building` (string) Building information. Example: "Building 1" - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.floor` (string) Floor information. Example: "2nd floor" - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.door` (string) Room, apartment, ... Example: "Room 14" - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.careOf` (string) A care of (c/o) party name. Example: "c/o John Doe" - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.primaryRegion` (object) Code list with codes that are _derived_ from subdivisions. A region for postal must provide a disjoint cut, in ISO 3166-2 it is not always the case (e.g. France 14 provinces, 95 departments, departments intersect with provinces). This means that additional work must be invested in curation of ISO 3166-2 code lists. So, while formally it the field type is ISO subdivision code, in fact it is a curated subset of ISO 3166-2, prepared for use in postal delivery. - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.secondaryRegion` (object) Locally governed region name second level, optionally code-list item. - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.secondaryRegion.name` (string) Name of a secondary region. Example: "Montgomery County" - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.secondaryRegion.ref` (object) Code of a secondary region. - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.secondaryRegion.ref.code` (string) Secondary region code. Example: "091" - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.tertiaryRegion` (object) Locally governed region name third level (e.g. Russia), optionally code-list item. - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.tertiaryRegion.name` (string) Name of a tertiary region. Example: "Montgomery County" - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.town` (object) City, town, village; a value from a code-list for towns; see ISO 19160-4 definition. - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.town.name` (string) Name of a town. Example: "Berlin" - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.town.ref` (object) Code of a town. - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.town.ref.code` (string) Town code. Example: "9000" - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.district` (object) An addressable area inside a town; see ISO 19160-4 definition: optional. - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.district.name` (string) Name of a district. Example: "Mitte" - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.country` (object) A value from a code-list for countries. - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.postCode` (string) Postal code (or Zip Code in the US, PLZ in Germany etc.). Example: "10115" - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.alternative` (object) Another type of address (e.g. service point delivery like PO box). - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.alternative.deliveryType` (object) A code-list containing a discriminator to select between address types. - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.alternative.deliveryType.code` (string) The code. Example: "POBOX" - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.alternative.deliveryServiceType` (string) A code-list containing a discriminator to select between address types. Enum: "POBoxDelivery", "PrivateBagDelivery", "PosteRestanteDelivery", "CompanyDelivery", "WorkerCampElectricityMeterDelivery", "WorkerCampBedDelivery", "Other" - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.alternative.deliveryServiceQualifier` (string) Needed as the same service identifier is only unique within the scope of the qualifier (i.e. same identifier could be used in different Post offices in the same town). Example: "Post Office SouthEast" - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.alternative.deliveryServiceIdentifier` (string) Identifier of the delivery service, e.g., the number of the PO Box. Unique within the scope of the deliveryServiceQualifier. Example: "1234" - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.coordinates` (object) The address as geo coordinates. - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.coordinates.latitude` (number) Latitude value of the coordinates. Example: "52.520008" - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.coordinates.longitude` (number) Longitude value of the coordinates. Example: "13.404954" - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.coordinates.altitude` (number) Altitude value of the coordinates. Example: "34.0" - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.scriptVariants` (array) Scripted variants of the organization's address. - `values.businessPartner.jsonRecord.addressData.organizationPostalAddress.scriptVariants.scriptCode` (object) Script code of the name of the organization address information. - `values.businessPartner.jsonRecord.addressData.emailAddresses` (object) Email addresses of the business partner. - `values.businessPartner.jsonRecord.addressData.emailAddresses.address` (string) The email address. Assumption: to be able to process special characters in the address all connected systems must be unicode enabled. EmailAddress according to external standard IETF RFC 5321. Example: "developer-portal@cdq.com" - `values.businessPartner.jsonRecord.addressData.websites` (object) Websites of the business partner. - `values.businessPartner.jsonRecord.addressData.websites.url` (string) The URL path for the website. Example: "https://www.developer.cdq.com" - `values.businessPartner.bankAccounts` (array) List of bank accounts of the Business Partner. - `values.businessPartner.bankAccounts.internationalBankAccountIdentifier` (string) The IBAN of a bank account. Example: "CH8800781619278412000" - `values.businessPartner.bankAccounts.internationalBankIdentifier` (string) (BIC/SWIFT) Bank identifier which is globally unique. Example: "KBSGCH22XXX" - `values.businessPartner.bankAccounts.nationalBankAccountIdentifier` (string) Identifier of a bank account in a national context, i.e. for a country. Example: "619278412000" - `values.businessPartner.bankAccounts.nationalBankIdentifier` (string) Bank identifier which is unique in a national context, i.e. for a country. Example: "00781" - `values.businessPartner.bankAccounts.countryCode` (string) ISO code to identify the country a bank account is registered in. Example: "DE" - `values.businessPartner.bankAccounts.bankAccountIdentifier` (string) Identifier of a bank account in a national or international context. Example: "CH8800781619278412000" - `values.additionalInformation` (array) Any additional information received during the original request. - `values.additionalInformation.key` (string) Key of the generic key/value map. Example: "KEY" - `values.additionalInformation.value` (string) Key of the generic key/value map. Example: "1" - `values.goldenRecordUse` (string) Describes if and how was business partner used in golden record composition. * - Base entry for golden record * - Entry used to add information to base entry Example: "PRIMARY" - `goldenRecord` (object) Represent a Business Partner record with the highest matching score based on data completeness. - `goldenRecord.cdqId` (string) CDQ ID of the Golden Record. Example: "VIES:PL1132639219" - `goldenRecord.metadata` (array) Metadata of the Golden Record. - `goldenRecord.metadata.modifiedAt` (string) Date of modification (ISO 8601-compliant). Example: "2025-08-27T14:27:22Z" - `goldenRecord.metadata.modifiedBy` (string) User or Client UUID which modified the resource. Example: "76248934691294444" - `goldenRecord.metadata.dataSource` (object) Data Source of the Data Pool. - `goldenRecord.metadata.dataSource.aleiPrefix` (string) The ALEI prefix element is the ISO 3166-2 code for country and subdivision if applicable followed by the stop character ‘.’ This is followed by an acronym representing the register maintained by the administrative agency for the governing body of a nation, state, or community that assigned the identifier element. The prefix is assigned by ECCMA. Example: "DE.RC" - `goldenRecord.metadata.dataSource.name` (string) Data Source name. Example: "VIES" - `goldenRecord.metadata.cdqId` (string) CDQ ID. Example: "VIES:PL1132639219" - `goldenRecord.businessPartnerChanges` (array) - `goldenRecord.businessPartnerChanges.externalIds` (array) - `goldenRecord.businessPartnerChanges.externalIds.externalId` (string) Value of the ExternalId of the business partner. Example: "123" - `goldenRecord.businessPartnerChanges.externalIds.dataSourceId` (string) Technical Key of the Provenance Name. Example: "VIES" - `goldenRecord.businessPartnerChanges.externalIds.id` (string) Unique identifier of the external ID. Example: "123" - `goldenRecord.businessPartnerChanges.externalIds.characterSet` (object) Character set. - `goldenRecord.businessPartnerChanges.externalIds.concept` (object) The Concept is a part of the CDQ data model. For example Address is a concept of the Business Partner and have many subconcepts as Locality, Thoroughfare, Administrative Area etc. - `goldenRecord.businessPartnerChanges.externalIds.concept.name` (string) Display name of the Concept. Example: "Address" - `goldenRecord.businessPartnerChanges.externalIds.concept.url` (string) URL to the documentation which summarizes all details of the Business Partner [Concepts](https://meta.cdq.com/Business_partner). Example: "https://meta.cdq.com/Business_partner" - `goldenRecord.businessPartnerChanges.externalIds.concept.technicalKey` (string) Technical key of the Concept. Example: "ADDRESS" - `goldenRecord.businessPartnerChanges.property` (object) In the context of updates property informs for which concept there was a change provided. - `goldenRecord.businessPartnerChanges.property.parentConcept` (object) The Concept is a part of the CDQ data model. For example Address is a concept of the Business Partner and have many subconcepts as Locality, Thoroughfare, Administrative Area etc. - `goldenRecord.businessPartnerChanges.property.name` (string) Name of the property. Example: "Minority Indicator Value" - `goldenRecord.businessPartnerChanges.property.technicalKey` (string) Technical key of the property. Example: "MINORITY_INDICATOR_VALUE" - `goldenRecord.businessPartnerChanges.property.url` (string) External documentation URL for this property. Example: "http://meta.cdq.com/Business_Partner/Identifier_Value" - `goldenRecord.businessPartnerChanges.property.content` (string) The current content of the property of the provided JSON. Example: "DE12345678" - `goldenRecord.businessPartnerChanges.property.contentSelector` (string) JSON path to the property in the provided JSON object. Example: "$.partnerProfile.minorityIndicator.value" - `goldenRecord.businessPartnerChanges.property.instanceSelectors` (array) - `goldenRecord.businessPartnerChanges.property.instanceSelectors.key` (string) JSON subpath to the property allowing to select concrete instance of a property in the provided JSON object. Example: "type.technicalKey" - `goldenRecord.businessPartnerChanges.property.instanceSelectors.value` (string) Value of a JSON subpath to the property allowing to select concrete instance of a property in the provided JSON object. Example: "CH_UID" - `goldenRecord.businessPartnerChanges.newContent` (string) New value after change Example: "AAB" - `goldenRecord.businessPartnerChanges.previousContent` (string) Value before change Example: "AAB" - `goldenRecord.businessPartnerChanges.provenance` (object) The source of the change or update. Could be the reference data source as VIES or Organization. - `goldenRecord.businessPartnerChanges.changeType` (string) Technical Key of the Property Change Type. Example: "MODIFIED" - `goldenRecord.businessPartnerChanges.changeClassification` (string) Gives a user an indicator how "much" the attribute was changed OR how important the change was. Allowed values are: * - Trivial change * - Minor change * - Major change * - Critical change Example: "MAJOR" - `goldenRecord.businessPartnerChanges.confidenceScore` (number) Confidence score which shows how confident CDQ is about enrichment of that property. Calculation dependes on property type, see here for a complete description. Example: "0.0" - `goldenRecord.businessPartnerChanges.maxConfidenceScore` (number) Maximum confidence score which is achievable for this property type. Note that the max value will change over time depending on the udnerlying algorithm which will be continously improved. Example: "1.0" - `debugInfo` (object) Debug information about the lookup. The lookup response contains the matching profile and the matching score. Can be activated by a feature . - `debugInfo.features` (array) List of features to be used during the lookup. - `debugInfo.features.feature` (string) Feature name. Example: "ACTIVATE_DATASOURCE_BVD" - `debugInfo.features.active` (boolean) Indicates whether the feature is active. Example: "true" - `debugInfo.request` (object) Specify the parameters for a Business Partner lookup. It allows you to: * filter the data sources and data mirrors that will be queried, * set a threshold for the data matching, * specify the maximum number of candidates to be returned, * activate or deactivate specific features. If outboundMapping is set, Business Partner is transformed to the desired mapped record in a key-value representation. - `debugInfo.request.limit` (integer) Number of items per page. Default value is 10. Example: "20" - `debugInfo.request.dataSources` (array) Filter data sources used during lookup. Example: ["VIES"] - `debugInfo.request.matchingThreshold` (number) Matching threshold for the lookup process. Default value is 0.5. Example: "0.5" - `debugInfo.request.maxCandidates` (integer) Maximum number of candidates to be returned. Default value is 50. Example: "50" - `debugInfo.request.storagesDataSources` (array) This field allows to filter data mirrors that will be queried. For each data mirror, data sources can also be filtered. Leave empty to include all available data mirrors in query. - `debugInfo.request.storagesDataSources.storageId` (string) ID of data mirror to be included during lookup. Example: "6479fd136811f0361e083211" - `debugInfo.request.storagesDataSources.dataSources` (array) IDs of data sources in specified data mirror to be included during lookup. Leave empty to include all data sources. - `debugInfo.request.featuresOn` (array) List of features to be activated. Example: ["ACTIVATE_DATASOURCE_BVD"] - `debugInfo.request.featuresOff` (array) List of features to be deactivated. Example: ["ACTIVATE_DATASOURCE_BVD"] - `debugInfo.request.configurationId` (string) Configuration ID used to set up lookup. If provided, those parameters will be affected. If any of them is provided in this request, will overwrite one from configuration (except for features which are merged): * * * * * (deprecated) * * * Example: "c074b9f3-abf0-4f8e-9a20-74deb6cfa2a4" - `debugInfo.externalServiceResponses` (array) List of external service responses. - `debugInfo.externalServiceResponses.apiError` (object) Detailed information about API errors. - `debugInfo.externalServiceResponses.apiError.status` (object) Details about status or error of a service - `debugInfo.externalServiceResponses.apiError.status.code` (integer, required) RFC 7231 status code for this error. Example: "400" - `debugInfo.externalServiceResponses.apiError.status.technicalKey` (string, required) Technical key describing the status or error Example: "OK" - `debugInfo.externalServiceResponses.apiError.status.details` (array) - `debugInfo.externalServiceResponses.apiError.status.details.id` (integer) 9-digit code which is uniquely identifying a message Example: 200000004 - `debugInfo.externalServiceResponses.apiError.status.details.message` (string) Human-readable message which may also be presented in user interface. Example: "Business Partner Name is mandatory." - `debugInfo.externalServiceResponses.apiError.status.details.technicalKey` (string) Technical key for the HTTP status code Example: "OK" - `debugInfo.externalServiceResponses.apiError.status.path` (string) Requested path which caused this error. Example: "/v2/businesspartners/lookup" - `debugInfo.externalServiceResponses.apiError.status.timestamp` (string) ISO 8601 representation of the timestamp. Example: "2025-08-27T14:27:22Z" - `debugInfo.externalServiceResponses.httpPath` (string) Requested path which caused this error. Example: "/v2/businesspartners/lookup" - `debugInfo.externalServiceResponses.status` (string) External service call status. Example: "OK" - `debugInfo.externalServiceResponses.message` (string) Received message of the external service. Example: "VIES_NOT_AVAILABLE - Vies is currently not available" - `debugInfo.externalServiceResponses.source` (string) Source of the response. Example: "CHUID" - `debugInfo.externalServiceResponses.additionalInformations` (array) Any additional information received during the original request. - `debugInfo.externalServiceResponses.httpStatus` (integer) RFC 7231 status code for this error. Example: "400" - `annotations` (array) The list of annotations. - `annotations.technicalKey` (string) Unique code of this annotation type. Example: "Ref-cred" - `annotations.url` (string) Page with information related to this annotation type. Example: "https://cdq.com/cred" - `annotations.message` (string) Content of annotation. Example: "Incorrect credentials" - `annotations.severity` (string) Additional information regarding results severity: * - Result is correct * - Result may be incomplete * - Result are not reliable * - Annotation is not related to results Example: "ERROR" ## Response 429 fields (application/json): - `status` (object) Details about status or error of a service - `status.code` (integer, required) RFC 7231 status code for this error. Example: "400" - `status.technicalKey` (string, required) Technical key describing the status or error Example: "OK" - `status.details` (array) - `status.details.id` (integer) 9-digit code which is uniquely identifying a message Example: 200000004 - `status.details.message` (string) Human-readable message which may also be presented in user interface. Example: "Business Partner Name is mandatory." - `status.details.technicalKey` (string) Technical key for the HTTP status code Example: "OK" - `status.path` (string) Requested path which caused this error. Example: "/v2/businesspartners/lookup" - `status.timestamp` (string) ISO 8601 representation of the timestamp. Example: "2025-08-27T14:27:22Z"