# List Business Partners Updates The Read Business Partner Updates endpoint provides an updated Business Partner structure and comprehensive Business Partner information from the Reference Data Sources. By default, only the latest version of a Business Partner from a single data source is provided. However, it's possible to access all historical updates (up to 3 months) by enabling the option. A list of updated Business Partners can be filtered in various ways, with tags being the most powerful and important. Tags combine concepts (e.g., , , ) with actions (e.g., , ). There are two types of classification filters: 1. summaryClassification: This filter provides Business Partners with a summary classification, which is determined by the highest classificationlevel among all Business Partner concepts. 2. conceptClassification: This filter indicates the classification of a specific concept of the Business Partner (e.g., name, street, legal form). Filtration by tag and works in pairs and identifies Business Partners where, for example, the was and this change was classified as . When filtering by tag and , the endpoint returns all Business Partners where the specified tags were added to the summary and the general summary classification is, for example, IDENTIFIER_ADDED, + highest classification for all updates =. Additional filtering options include country, provenance, and external IDs. Providing the data source (or your mirror) in the request can enhance response speed. It's possible to check the total number of updates using featuresOn NUMBER_OF_TOTAL, but can slow down the response. We recommend periodically reading all Business Partners (at least once) to improve the efficiency of specific filtrations. Endpoint: GET /v5/storages/{storageId}/businesspartners/updates Version: 5 Security: apiKey ## Path parameters: - `storageId` (string, required) Unique identifier of the Storage. Example: "72d6900fce6b326088f5d9d91049e3e6" ## Query parameters: - `startAfter` (string) Only items with an ID greater than the given one will be retrieved. When nextStartAfter provided in the response, should be used instead of the ID as an indicator for a next page. Example: "5712566172571652" - `limit` (integer) Number of items to be returned on the page. Example: "100" - `businessPartnerIds` (array) Only show updates for listed Business Partner IDs. When providing list of Business Partner IDs, limit is ignored to provide full page. Example: ["63e635235c06b7396330fe40"] - `externalIds` (array) Filter updates by Business Partner externalId, limit is ignored to provide full page. When used with the businessPartnerIds parameter, only business partners that have one of the specified externalIds AND one of the specified businessPartnerIds will be returned. Example: ["The ID managed in the customer's SAP systems."] - `provenanceTechnicalKeys` (array) Show updates for selected provenances by technical keys. Example: ["VIES"] - `exceptProvenanceTechnicalKeys` (array) Show updates for all provenances except provided by technical keys. By default, includes ORGANIZATION if not present on provenanceTechnicalKeys list. Example: ["VIES"] - `dataTransformationDefinitionId` (string) When dataTransformationDefinitionId is provided, map updatedBusinessPartner using that transformation. Example: "SAP.ODM" - `from` (string) Only show updates which have been modified after this date (ISO 8601). Default is to show the 'last seven days' and farthest in the past is 'since three month'. Example: "2025-09-10T10:12:35Z" - `dataSources` (array) Filter by data sources (name or id). Example: ["\"CUSTOM_DATA_SOURCE\" or \"648824a691d8d2503d65103e\""] - `countryShortNames` (array) Filter by countries. Example: ["CH"] - `summaryClassifications` (array) Filter by provided summary classifications (logical OR). Enum: "CRITICAL", "REJECTED", "MAJOR", "MINOR", "TRIVIAL", "CONFIRMED", "UNCHANGED" - `updateTags` (array) Filter by update summary tags. Enum: "BANKRUPTCY_BUSINESS_PARTNER", "BUSINESS_PARTNER_CATEGORY_ADDED", "BUSINESS_PARTNER_CATEGORY_MODIFIED", "BUSINESS_PARTNER_CLASSIFICATION_ADDED", "BUSINESS_PARTNER_CLASSIFICATION_MODIFIED", "BUSINESS_PARTNER_STATUS_ADDED", "BUSINESS_PARTNER_STATUS_MODIFIED", "BUSINESS_PARTNER_TYPE_ADDED", "BUSINESS_PARTNER_TYPE_MODIFIED", "DIRECT_LEGAL_RELATION_ADDED", "DIRECT_LEGAL_RELATION_MODIFIED", "DISSOLUTION_BUSINESS_PARTNER", "DOMESTIC_BRANCH_RELATION_ADDED", "DOMESTIC_BRANCH_RELATION_MODIFIED", "DOMESTIC_COMMERCIAL_ULTIMATE_RELATION_ADDED", "DOMESTIC_COMMERCIAL_ULTIMATE_RELATION_MODIFIED", "DOMESTIC_LEGAL_ULTIMATE_RELATION_ADDED", "DOMESTIC_LEGAL_ULTIMATE_RELATION_MODIFIED", "GLOBAL_COMMERCIAL_ULTIMATE_RELATION_ADDED", "GLOBAL_COMMERCIAL_ULTIMATE_RELATION_MODIFIED", "GLOBAL_LEGAL_ULTIMATE_RELATION_ADDED", "GLOBAL_LEGAL_ULTIMATE_RELATION_MODIFIED", "IDENTIFIER_ADDED", "IDENTIFIER_HARMONIZED", "IDENTIFIER_MODIFIED", "IDENTIFIER_STATUS_ADDED", "IDENTIFIER_STATUS_MODIFIED", "IDENTIFIER_VALUE_MODIFIED", "IN_LIQUIDATION_BUSINESS_PARTNER", "INACTIVE_BUSINESS_PARTNER", "INSOLVENCY_BUSINESS_PARTNER", "INTERNAL_RELATION_ADDED", "INTERNAL_RELATION_MODIFIED", "INTERNATIONAL_BRANCH_RELATION_ADDED", "INTERNATIONAL_BRANCH_RELATION_MODIFIED", "LEGAL_FORM_ADDED", "LEGAL_FORM_MODIFIED", "LEI_DIRECT_PARENT_ADDED", "LEI_DIRECT_PARENT_MODIFIED", "LEI_INTERNATIONAL_BRANCH_ADDED", "LEI_INTERNATIONAL_BRANCH_MODIFIED", "LEI_ULTIMATE_PARENT_ADDED", "LEI_ULTIMATE_PARENT_MODIFIED", "LOCAL_ADDRESS_ADDED", "LOCAL_ADDRESS_ADMINISTRATIVE_AREA_ADDED", "LOCAL_ADDRESS_ADMINISTRATIVE_AREA_MODIFIED", "LOCAL_ADDRESS_COUNTRY_ADDED", "LOCAL_ADDRESS_COUNTRY_MODIFIED", "LOCAL_ADDRESS_GEO_COORDINATES_ADDED", "LOCAL_ADDRESS_GEO_COORDINATES_MODIFIED", "LOCAL_ADDRESS_LOCALITY_ADDED", "LOCAL_ADDRESS_LOCALITY_MODIFIED", "LOCAL_ADDRESS_MODIFIED", "LOCAL_ADDRESS_POSTAL_DELIVERY_POINT_ADDED", "LOCAL_ADDRESS_POSTAL_DELIVERY_POINT_MODIFIED", "LOCAL_ADDRESS_POST_CODE_ADDED", "LOCAL_ADDRESS_POST_CODE_MODIFIED", "LOCAL_ADDRESS_PREMISE_ADDED", "LOCAL_ADDRESS_PREMISE_MODIFIED", "LOCAL_ADDRESS_THOROUGHFARE_ADDED", "LOCAL_ADDRESS_THOROUGHFARE_MODIFIED", "LOCAL_NAME_ADDED", "LOCAL_NAME_MODIFIED", "OTHER_NAME_ADDED", "OTHER_NAME_MODIFIED", "POST_CODE_HARMONIZED", "LEGAL_ADDRESS_ADDED", "LEGAL_ADDRESS_ADMINISTRATIVE_AREA_ADDED", "LEGAL_ADDRESS_ADMINISTRATIVE_AREA_MODIFIED", "LEGAL_ADDRESS_COUNTRY_ADDED", "LEGAL_ADDRESS_COUNTRY_MODIFIED", "LEGAL_ADDRESS_GEO_COORDINATES_ADDED", "LEGAL_ADDRESS_GEO_COORDINATES_MODIFIED", "LEGAL_ADDRESS_LOCALITY_ADDED", "LEGAL_ADDRESS_LOCALITY_MODIFIED", "LEGAL_ADDRESS_MODIFIED", "LEGAL_ADDRESS_POSTAL_DELIVERY_POINT_ADDED", "LEGAL_ADDRESS_POSTAL_DELIVERY_POINT_MODIFIED", "LEGAL_ADDRESS_POST_CODE_ADDED", "LEGAL_ADDRESS_POST_CODE_MODIFIED", "LEGAL_ADDRESS_PREMISE_ADDED", "LEGAL_ADDRESS_PREMISE_MODIFIED", "LEGAL_ADDRESS_THOROUGHFARE_ADDED", "LEGAL_ADDRESS_THOROUGHFARE_MODIFIED", "LEGAL_NAME_ADDED", "LEGAL_NAME_MODIFIED", "RESTRUCTURING_BUSINESS_PARTNER", "RELATION_ADDED", "RELATION_MODIFIED", "SEED_UPDATE", "UPDATE_PROPOSAL_INDICATOR", "VAT_PAYER_STATUS_ADDED", "VAT_PAYER_STATUS_MODIFIED", "VAT_REGISTERED_ADDRESS_ADDED", "VAT_REGISTERED_ADDRESS_ADMINISTRATIVE_AREA_ADDED", "VAT_REGISTERED_ADDRESS_ADMINISTRATIVE_AREA_MODIFIED", "VAT_REGISTERED_ADDRESS_COUNTRY_ADDED", "VAT_REGISTERED_ADDRESS_COUNTRY_MODIFIED", "VAT_REGISTERED_ADDRESS_GEO_COORDINATES_ADDED", "VAT_REGISTERED_ADDRESS_GEO_COORDINATES_MODIFIED", "VAT_REGISTERED_ADDRESS_LOCALITY_ADDED", "VAT_REGISTERED_ADDRESS_LOCALITY_MODIFIED", "VAT_REGISTERED_ADDRESS_MODIFIED", "VAT_REGISTERED_ADDRESS_POSTAL_DELIVERY_POINT_ADDED", "VAT_REGISTERED_ADDRESS_POSTAL_DELIVERY_POINT_MODIFIED", "VAT_REGISTERED_ADDRESS_POST_CODE_ADDED", "VAT_REGISTERED_ADDRESS_POST_CODE_MODIFIED", "VAT_REGISTERED_ADDRESS_PREMISE_ADDED", "VAT_REGISTERED_ADDRESS_PREMISE_MODIFIED", "VAT_REGISTERED_ADDRESS_THOROUGHFARE_ADDED", "VAT_REGISTERED_ADDRESS_THOROUGHFARE_MODIFIED", "VAT_REGISTERED_NAME_ADDED", "VAT_REGISTERED_NAME_MODIFIED", "VALUE_MODIFIED" - `updateTagsProfiles` (array) Profiled filter by update summary tags. Enum: "ADDRESS_DATA", "LEGAL_DATA", "RELATIONS", "VAT_DATA" - `conceptClassifications` (array) Filter by provided concept classifications (logical OR). When used with the updateTags parameter, only those updates are presented, that match together with respective tag. Enum: "CRITICAL", "REJECTED", "MAJOR", "MINOR", "TRIVIAL", "CONFIRMED", "UNCHANGED" - `featuresOn` (array) Features to be used during the read Business Partner updates: * - Applies curation decisions from Decision Log to Business Partners in if any decisions found. Requires FETCH_STORAGE_BUSINESS_PARTNER feature. By default, deactivated. * - Include historical updates into results. By default, deactivated. * - Fetch Business Partner from a storage and set in . By default, deactivated. * - Allows to switch fetching the total number of records to improve performance. By default, deactivated. Enum: "APPLY_CURATION_DECISIONS", "FETCH_HISTORICAL_UPDATES", "FETCH_STORAGE_BUSINESS_PARTNER", "NUMBER_OF_TOTAL" - `featuresOff` (array) Features to be used during the read Business Partner updates: * - Applies curation decisions from Decision Log to Business Partners in if any decisions found. Requires FETCH_STORAGE_BUSINESS_PARTNER feature. By default, deactivated. * - Include historical updates into results. By default, deactivated. * - Fetch Business Partner from a storage and set in . By default, deactivated. * - Allows to switch fetching the total number of records to improve performance. By default, deactivated. Enum: "APPLY_CURATION_DECISIONS", "FETCH_HISTORICAL_UPDATES", "FETCH_STORAGE_BUSINESS_PARTNER", "NUMBER_OF_TOTAL" ## Response 200 fields (application/json): - `limit` (integer) Number of items per page. Example: "100" - `total` (integer) Total number of items which can be paged. Example: "67" - `startAfter` (string) The ID which is used to read the page. Example: "5712566172571652" - `nextStartAfter` (string) Available only when you used USE_NEXT_START_AFTER feature. Provides a value to be used as a startAfter in next page request. Example: "5712566172571652" - `values` (array) List of Business Partner Updates. - `values.id` (string) ID of the Business Partner Update. Example: "5712566172571652" - `values.businessPartnerId` (string) A CDQ ID identifies a business partner uniquely in the context of the Corporate Data League. Example: "63e635235c06b7396330fe40" - `values.externalBusinessPartnerId` (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.updatedBusinessPartner` (object) A Business Partner which contains also contextual information about applied updates. - `values.updatedBusinessPartner.id` (string) A CDQ ID identifies a business partner uniquely in the context of the Corporate Data League. Example: "63e635235c06b7396330fe40" - `values.updatedBusinessPartner.summary` (object) Summarizes the applied updates for easy consumption. - `values.updatedBusinessPartner.summary.tags` (array) Example: ["IDENTIFIER_ADDED"] - `values.updatedBusinessPartner.summary.classification` (object) Gives a user an indicator how "much" the attribute was changed OR how important the change was. - `values.updatedBusinessPartner.summary.classification.technicalKey` (string, required) Technical key of an update classification. Example: "MAJOR" - `values.updatedBusinessPartner.summary.classification.reason` (string) Reason why this classification has been applied Example: "The modified post code has deprecated format." - `values.updatedBusinessPartner.names` (array) - `values.updatedBusinessPartner.names.type` (object) The type of the name, e.g. a locally used name or an international version. - `values.updatedBusinessPartner.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.updatedBusinessPartner.names.type.name` (string) Display label for the Name Type. Example: "Local Name" - `values.updatedBusinessPartner.names.type.technicalKey` (string) Technical Keys of the Name Type. Example: "LOCAL" - `values.updatedBusinessPartner.names.value` (string) The actual name. Example: "Corporate Data Quality AG" - `values.updatedBusinessPartner.names.shortName` (string) The abbreviated variant of a company's full name. Example: "CDQ AG" - `values.updatedBusinessPartner.names.language` (object) Naming of a language according to ISO 639-1. - `values.updatedBusinessPartner.names.language.name` (string) ISO 639-1 name of language. Example: "German" - `values.updatedBusinessPartner.names.language.technicalKey` (string) ISO 639-1 two-letter code of languages. Example: "DE" - `values.updatedBusinessPartner.names.details` (array) - `values.updatedBusinessPartner.names.details.value` (string) Value of additional information to a [Business Partner Name](https://meta.cdq.com/Business_partner/name). Example: "Corporate Data Quality AG - Marketing Department" - `values.updatedBusinessPartner.names.details.type` (object) Type of additional information to a [Business Partner Name](https://meta.cdq.com/Business_partner/name). - `values.updatedBusinessPartner.names.details.type.name` (string) Name Detail Type Name of additional information to a [Business Partner Name](https://meta.cdq.com/Business_partner/name). Example: "Legal Entity" - `values.updatedBusinessPartner.names.details.type.url` (string) Name Detail Type Url of additional information to a [Business Partner Name](https://meta.cdq.com/Business_partner/name). Example: "https://meta.cdq.com/Business_partner/type" - `values.updatedBusinessPartner.names.details.type.technicalKey` (string) Name Detail Type Technical Key of additional information to a [Business Partner Name](https://meta.cdq.com/Business_partner/name). Example: "LEGAL_ENTITY" - `values.updatedBusinessPartner.names.updateAssessment` (object) Update assessment for a name. - `values.updatedBusinessPartner.names.updateAssessment.action` (object, required) Type of update action which has been applied. - `values.updatedBusinessPartner.names.updateAssessment.action.technicalKey` (string) Technical key of an update assessment action. Example: "ADDED" - `values.updatedBusinessPartner.names.updateAssessment.provenances` (array) - `values.updatedBusinessPartner.names.updateAssessment.provenances.name` (string) Display Name of the Provenance Name. Example: "VIES" - `values.updatedBusinessPartner.names.updateAssessment.provenances.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.updatedBusinessPartner.names.updateAssessment.provenances.technicalKey` (string) Technical Key of the Provenance Name. Example: "VIES" - `values.updatedBusinessPartner.names.updateAssessment.provenances.cdqId` (string) The ID provided for a linkage with the source by CDQ. Example: "VIES:PL8660001429" - `values.updatedBusinessPartner.names.updateAssessment.provenances.subscribers` (integer) Number of subscribers. Example: "50" - `values.updatedBusinessPartner.names.updateAssessment.modifiedAt` (string) Date of modification (ISO 8601-compliant). Example: "2025-09-10T10:12:36Z" - `values.updatedBusinessPartner.names.updateAssessment.before` (object) The name of a Business Partner. - `values.updatedBusinessPartner.legalForm` (object) A legal form which contains also contextual information about applied updates. - `values.updatedBusinessPartner.legalForm.name` (string) Display of the Legal Form. Example: "Aktiengesellschaft" - `values.updatedBusinessPartner.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.updatedBusinessPartner.legalForm.technicalKey` (string) Technical Key of a Legal Form. Descriptions of below enums contain , and . Example: "DE_9866" - `values.updatedBusinessPartner.legalForm.mainAbbreviation` (string) The primary abbreviation of a legal form, i.e. the most commonly used abbreviation in a country. Example: "AG" - `values.updatedBusinessPartner.legalForm.categories` (array) List of Legal Form Categories. - `values.updatedBusinessPartner.legalForm.categories.name` (string) Descriptive display name of the Legal Form Category. Example: "Limited Liability Company" - `values.updatedBusinessPartner.legalForm.categories.shortName` (string) Short display name of the Legal Form Category. Example: "LLC" - `values.updatedBusinessPartner.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.updatedBusinessPartner.legalForm.categories.technicalKey` (string) Technical Key of the [Legal Form Category](https://meta.cdq.com/Business_partner/legal_form/category). Example: "LIMITED" - `values.updatedBusinessPartner.legalForm.updateAssessment` (object) Update assessment for a legal form. - `values.updatedBusinessPartner.legalForm.updateAssessment.before` (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.updatedBusinessPartner.identifiers` (array) - `values.updatedBusinessPartner.identifiers.type` (object) Type of the identifier. - `values.updatedBusinessPartner.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.updatedBusinessPartner.identifiers.type.name` (string) Display label for the Identifier. Example: "CH_VAT_ID" - `values.updatedBusinessPartner.identifiers.type.technicalKey` (string) Technical key of the type of the Identifier. Example: "CH_VAT_ID" - `values.updatedBusinessPartner.identifiers.value` (string) Value of the identifier. Example: "CHE-218.608.886 HR/MWST" - `values.updatedBusinessPartner.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.updatedBusinessPartner.identifiers.issuingBody.name` (string) Preferred display label for an Issuing Body. Example: "Amtsgericht Aachen" - `values.updatedBusinessPartner.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.updatedBusinessPartner.identifiers.issuingBody.technicalKey` (string) Technical key of the Issuing Body. Example: "Amtsgericht Aachen" - `values.updatedBusinessPartner.identifiers.issuingBody.jurisdiction` (object) The authority of an official organization to make decisions and judgments in a particular administrative area. - `values.updatedBusinessPartner.identifiers.issuingBody.jurisdiction.country` (object) Country consisting of the country name and country code (ISO 3166-1 alpha-2). - `values.updatedBusinessPartner.identifiers.issuingBody.jurisdiction.country.shortName` (string) Country code (ISO 3166-1 alpha-2). Example: "CH" - `values.updatedBusinessPartner.identifiers.issuingBody.jurisdiction.country.value` (string) Country name (ISO 3166-1 alpha-2). Example: "Switzerland" - `values.updatedBusinessPartner.identifiers.status` (object) Describes the status of an identifier with respect to its level of activity (e.g. out of business) or legally relevant conditions (e.g. in liquidation). - `values.updatedBusinessPartner.identifiers.status.name` (string) Display label for the Identifier Status Name. Example: "ACTIVE" - `values.updatedBusinessPartner.identifiers.status.technicalKey` (string) Technical key of the Identifier Status. Example: "ACTIVE" - `values.updatedBusinessPartner.identifiers.updateAssessment` (object) Update assessment for an identifier. - `values.updatedBusinessPartner.identifiers.updateAssessment.before` (object) Identifies a Business Partner in a given context uniquely such as a VAT identification number. - `values.updatedBusinessPartner.categories` (array) - `values.updatedBusinessPartner.categories.name` (string) Display name of the Business Partner Category Name. Example: "Hotel" - `values.updatedBusinessPartner.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.updatedBusinessPartner.categories.technicalKey` (string) Technical Key of the Business Partner Category. Example: "HOTEL" - `values.updatedBusinessPartner.categories.updateAssessment` (object) Update assessment for a Business Partner category. - `values.updatedBusinessPartner.categories.updateAssessment.before` (object) A business partner category of a business partner groups similar business partners. - `values.updatedBusinessPartner.status` (object) A business partner status which contains also contextual information about applied updates. - `values.updatedBusinessPartner.status.type` (object) The standardized status which the business partner currently has. - `values.updatedBusinessPartner.status.type.name` (string) Display name of the Business Partner Status. Example: "In Liquidation" - `values.updatedBusinessPartner.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.updatedBusinessPartner.status.type.technicalKey` (string) Technical Key of the Business Parter Status. Example: "IN_LIQUIDATION" - `values.updatedBusinessPartner.status.officialDenotation` (string) The status as provided by an official register. Example: "Good Standing" - `values.updatedBusinessPartner.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-09-10T10:12:36Z" - `values.updatedBusinessPartner.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-09-10T10:12:36Z" - `values.updatedBusinessPartner.status.updateAssessment` (object) Update assessment for a Business Partner status. - `values.updatedBusinessPartner.status.updateAssessment.before` (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.updatedBusinessPartner.addresses` (array) - `values.updatedBusinessPartner.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.updatedBusinessPartner.addresses.version.characterSet` (object) Character set. Available values can be found [here](https://meta.cdq.com/Address/version/character_set). - `values.updatedBusinessPartner.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.updatedBusinessPartner.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.updatedBusinessPartner.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.updatedBusinessPartner.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.updatedBusinessPartner.addresses.externalId` (string) ID the address has in the external system where the record originates from. Example: "1" - `values.updatedBusinessPartner.addresses.metadata` (object) Specifies the language and primary data provenance. - `values.updatedBusinessPartner.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.updatedBusinessPartner.addresses.careOf.value` (string) Value of the CareOf. Example: "CDQ GmbH c/o Product Department" - `values.updatedBusinessPartner.addresses.contexts` (array) - `values.updatedBusinessPartner.addresses.contexts.value` (string) Value of the Address Context. Example: "Production hall 7, Storage field 8." - `values.updatedBusinessPartner.addresses.country` (object) A country which contains also contextual information about applied updates. - `values.updatedBusinessPartner.addresses.country.updateAssessment` (object) Update assessment for a country. - `values.updatedBusinessPartner.addresses.country.updateAssessment.before` (object) Country consisting of the country name and country code (ISO 3166-1 alpha-2). - `values.updatedBusinessPartner.addresses.administrativeAreas` (array) - `values.updatedBusinessPartner.addresses.administrativeAreas.value` (string) Name of the [Administrative Area](https://meta.cdq.com/Address/administrative_area). Example: "Sankt Gallen" - `values.updatedBusinessPartner.addresses.administrativeAreas.shortName` (string) Abbreviation for the [Administrative Area](https://meta.cdq.com/Address/administrative_area). Example: "SG" - `values.updatedBusinessPartner.addresses.administrativeAreas.isoCode` (string) ISO 3166-2 code which uniquely defines the names of countries and their subdivisions (e.g., provinces or states). Example: "CH-SG" - `values.updatedBusinessPartner.addresses.administrativeAreas.type` (object) Type of the [Administrative Area](https://meta.cdq.com/Address/administrative_area). - `values.updatedBusinessPartner.addresses.administrativeAreas.type.name` (string) Display label for the Administrative Area Type. Example: "COUNTY" - `values.updatedBusinessPartner.addresses.administrativeAreas.type.url` (string) URL to the documentation which summarizes all details of the [Administrative Area](https://meta.cdq.com/Address/administrative_area/type). Example: "https://meta.cdq.com/Address/administrative_area/type" - `values.updatedBusinessPartner.addresses.administrativeAreas.type.technicalKey` (string) Technical key of the Administrative Area. Example: "COUNTY" - `values.updatedBusinessPartner.addresses.administrativeAreas.updateAssessment` (object) Update assessment for an administrative area. - `values.updatedBusinessPartner.addresses.administrativeAreas.updateAssessment.before` (object) A top-level geographical or political area division in a country. - `values.updatedBusinessPartner.addresses.postCodes` (array) - `values.updatedBusinessPartner.addresses.postCodes.value` (string) Effective [post code](https://meta.cdq.com/Address/post_code). Example: "9000" - `values.updatedBusinessPartner.addresses.postCodes.type` (object) A country specific code for a certain [address](https://meta.cdq.com/Address) component or a combination of [address](https://meta.cdq.com/Address) components, e.g. [locality](https://meta.cdq.com/Address/locality). - `values.updatedBusinessPartner.addresses.postCodes.type.name` (string) Display label for the Post Code Type. Example: "Regular" - `values.updatedBusinessPartner.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.updatedBusinessPartner.addresses.postCodes.type.technicalKey` (string) Technical key of the Post Code. Example: "REGULAR" - `values.updatedBusinessPartner.addresses.postCodes.updateAssessment` (object) Update assessment for a post code. - `values.updatedBusinessPartner.addresses.postCodes.updateAssessment.before` (object) A country specific code for a certain [address](https://meta.cdq.com/Address) component or a combination of [address](https://meta.cdq.com/Address) components, e.g. [locality](https://meta.cdq.com/Address/locality). - `values.updatedBusinessPartner.addresses.localities` (array) - `values.updatedBusinessPartner.addresses.localities.type` (object) Type of the [Locality](https://meta.cdq.com/Address/locality). - `values.updatedBusinessPartner.addresses.localities.type.name` (string) Display label for the Locality Type. Example: "City" - `values.updatedBusinessPartner.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.updatedBusinessPartner.addresses.localities.type.technicalKey` (string) Technical Key of the Locality Type. Example: "CITY" - `values.updatedBusinessPartner.addresses.localities.shortName` (string) Abbreviation of the [Locality](https://meta.cdq.com/Address/locality). Example: "St. Gallen" - `values.updatedBusinessPartner.addresses.localities.value` (string) Name of the [Locality](https://meta.cdq.com/Address/locality). Example: "Sankt Gallen" - `values.updatedBusinessPartner.addresses.localities.updateAssessment` (object) Update assessment for a locality. - `values.updatedBusinessPartner.addresses.localities.updateAssessment.before` (object) 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. - `values.updatedBusinessPartner.addresses.thoroughfares` (array) - `values.updatedBusinessPartner.addresses.thoroughfares.type` (object) Type of the [Thoroughfare](https://meta.cdq.com/Address/thoroughfare). - `values.updatedBusinessPartner.addresses.thoroughfares.type.name` (string) Display label for the Thoroughfare Type Name. Example: "Industrial zone" - `values.updatedBusinessPartner.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.updatedBusinessPartner.addresses.thoroughfares.type.technicalKey` (string) Technical key of the Thoroughfare Type. Example: "INDUSTRIAL_ZONE" - `values.updatedBusinessPartner.addresses.thoroughfares.shortName` (string) Abbreviation of the [Thoroughfare](https://meta.cdq.com/Address/thoroughfare). Example: "Lukasstr. 4" - `values.updatedBusinessPartner.addresses.thoroughfares.number` (string) Number of the [Thoroughfare](https://meta.cdq.com/Address/thoroughfare). Example: "4" - `values.updatedBusinessPartner.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.updatedBusinessPartner.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.updatedBusinessPartner.addresses.thoroughfares.direction` (string) Direction of the [Thoroughfare](https://meta.cdq.com/Address/thoroughfare). Example: "221-bis Baker Street, North" - `values.updatedBusinessPartner.addresses.thoroughfares.updateAssessment` (object) Update assessment for a thoroughfare. - `values.updatedBusinessPartner.addresses.thoroughfares.updateAssessment.before` (object) 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. - `values.updatedBusinessPartner.addresses.premises` (array) - `values.updatedBusinessPartner.addresses.premises.value` (string) The actual value of a Premise in the language of the address. Example: "Lukasstraße 4" - `values.updatedBusinessPartner.addresses.premises.shortName` (string) Abbreviation of the Premise. Example: "Lukasstr. 4" - `values.updatedBusinessPartner.addresses.premises.number` (string) Number of the Premise. Example: "4" - `values.updatedBusinessPartner.addresses.premises.type` (object) Type of the Premise. - `values.updatedBusinessPartner.addresses.premises.type.name` (string) Display label for the Premise Type. Example: "Factory" - `values.updatedBusinessPartner.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.updatedBusinessPartner.addresses.premises.type.technicalKey` (string) Technical key of the Premise Type. Example: "FACTORY" - `values.updatedBusinessPartner.addresses.premises.updateAssessment` (object) Update assessment for a premise. - `values.updatedBusinessPartner.addresses.premises.updateAssessment.before` (object) A premise is a tract of land including its buildings. A premise may have several sublevels to precisely identify. - `values.updatedBusinessPartner.addresses.postalDeliveryPoints` (array) - `values.updatedBusinessPartner.addresses.postalDeliveryPoints.type` (object) A single mailbox or other place at which postal mail is delivered. - `values.updatedBusinessPartner.addresses.postalDeliveryPoints.type.name` (string) Display label for the Postal Delivery Point Type. Example: "Mailbox" - `values.updatedBusinessPartner.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.updatedBusinessPartner.addresses.postalDeliveryPoints.type.technicalKey` (string) Technical key of the Postal Delivery Point. Example: "MAILBOX" - `values.updatedBusinessPartner.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.updatedBusinessPartner.addresses.postalDeliveryPoints.number` (string) Number of the [Postal Delivery Point](https://meta.cdq.com/Address/postal_delivery_point). Example: "460" - `values.updatedBusinessPartner.addresses.postalDeliveryPoints.value` (string) Value of the [Postal Delivery Point](https://meta.cdq.com/Address/postal_delivery_point). Example: "Postfach" - `values.updatedBusinessPartner.addresses.postalDeliveryPoints.updateAssessment` (object) Update assessment for a postal delivery point. - `values.updatedBusinessPartner.addresses.postalDeliveryPoints.updateAssessment.before` (object) A single mailbox or other place at which postal mail is delivered. - `values.updatedBusinessPartner.addresses.geographicCoordinates` (object) Geographic coordinates which contains also contextual information about applied updates. - `values.updatedBusinessPartner.addresses.geographicCoordinates.latitude` (number) Plain on the earth's surface north or south of the equator. Example: "47.439549" - `values.updatedBusinessPartner.addresses.geographicCoordinates.longitude` (number) Plain on the earth's surface east or west of a meridian. Example: "9.395275" - `values.updatedBusinessPartner.addresses.geographicCoordinates.updateAssessment` (object) Update assessment for geographic coordinates. - `values.updatedBusinessPartner.addresses.geographicCoordinates.updateAssessment.before` (object) Decimal geographic coordinates (WGS 84 - reference coordinate system). - `values.updatedBusinessPartner.addresses.types` (array) - `values.updatedBusinessPartner.addresses.types.name` (string) Display label for the Address Type. Example: "Legal Address" - `values.updatedBusinessPartner.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.updatedBusinessPartner.addresses.types.technicalKey` (string) Technical key of the Address Type. Example: "LEGAL_ADDRESS" - `values.updatedBusinessPartner.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.updatedBusinessPartner.profile` (object) A legal form which contains also contextual information about applied updates. - `values.updatedBusinessPartner.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.updatedBusinessPartner.profile.minorityIndicator.value` (string) The actual value of the minority indicator, representing the minority group. Example: "Social enterprise" - `values.updatedBusinessPartner.profile.classifications` (array) List of Classifications. - `values.updatedBusinessPartner.profile.classifications.value` (string) A textual description of the Classification. Example: "Manufacture of pesticides and other agrochemical products." - `values.updatedBusinessPartner.profile.classifications.code` (string) Code that classifies the business partner. Example: "20.20Z" - `values.updatedBusinessPartner.profile.classifications.type` (object) Type of classification such as NACE, SIC, NAF or other industry classification standards. - `values.updatedBusinessPartner.profile.classifications.type.name` (string) Display label for the Classification Type. Example: "NAF 2003" - `values.updatedBusinessPartner.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.updatedBusinessPartner.profile.classifications.type.technicalKey` (string) TechnicalKey for the Classification Type. Example: "NAF 2003" - `values.updatedBusinessPartner.profile.phoneNumbers` (array) List of Phone Numbers. - `values.updatedBusinessPartner.profile.phoneNumbers.countryPrefix` (string) The country prefix of a phone number. Example: "+41" - `values.updatedBusinessPartner.profile.phoneNumbers.number` (string) The complete phone number without any country prefixes. Example: "71 571 10 40" - `values.updatedBusinessPartner.profile.phoneNumbers.type` (object) The type of phone number such as mobile phone or fixed line [here](https://meta.cdq.com/Business_partner/partner_profile/phone_number/type). - `values.updatedBusinessPartner.profile.phoneNumbers.type.name` (string) Display label for a Phone Number Type Name. Example: "FAX" - `values.updatedBusinessPartner.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.updatedBusinessPartner.profile.phoneNumbers.type.technicalKey` (string) Technical Keys of the PhoneNumber. Example: "FAX" - `values.updatedBusinessPartner.profile.phoneNumbers.value` (string) The actual complete phone number incl. country prefix. Example: "+41 71 571 10 40" - `values.updatedBusinessPartner.profile.websites` (array) List of Websites. - `values.updatedBusinessPartner.profile.websites.url` (string) The actual company website URL. Example: "https://cdq.com" - `values.updatedBusinessPartner.profile.websites.type` (object) Describes the type of website of a business partner, e.g. corporate website, official LinkedIn profile, etc. - `values.updatedBusinessPartner.profile.websites.type.name` (string) Display label for a Website Type Name Example: "Corporate Website" - `values.updatedBusinessPartner.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.updatedBusinessPartner.profile.websites.type.technicalKey` (string) Technical Keys of the Website Type Name. Example: "WEBSITE_TYPE_CORPORATE" - `values.updatedBusinessPartner.profile.contactEmails` (array) List of Contact Emails. - `values.updatedBusinessPartner.profile.contactEmails.value` (string) Value of the email address of the Business Partner. Example: "developer-portal@cdq.com" - `values.updatedBusinessPartner.profile.tags` (array) List of Tags. - `values.updatedBusinessPartner.profile.tags.value` (string) Value of the tag. Example: "Warehouse" - `values.updatedBusinessPartner.profile.tags.type` (object) A type that specifies the nature of the tag. - `values.updatedBusinessPartner.profile.tags.type.technicalKey` (string, required) Technical Key of the Tag. Example: "WAREHOUSE" - `values.updatedBusinessPartner.profile.vatPayerStatus` (object) Shows whether the Business Partner is a VAT payer. - `values.updatedBusinessPartner.profile.vatPayerStatus.publicationDate` (string) Date of publication Example: "2025-09-10T10:12:36Z" - `values.updatedBusinessPartner.profile.vatPayerStatus.status` (object) Payer Status. - `values.updatedBusinessPartner.profile.vatPayerStatus.status.name` (string) Name of Vat payer status. Available values RELIABLE and UNRELIABLE Example: "RELIABLE" - `values.updatedBusinessPartner.profile.vatPayerStatus.status.technicalKey` (string) Technical key of Vat payer status Example: "VAT_PAYER_STATUS" - `values.updatedBusinessPartner.profile.vatPayerStatus.registrationAuthority` (object) Shows the registration authority of the Business Partner. - `values.updatedBusinessPartner.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.updatedBusinessPartner.profile.vatPayerStatus.registrationAuthority.registrationAuthorityEntityId` (string) The identifier of the Entity at the indicated registration authority. Example: "RA000009" - `values.updatedBusinessPartner.profile.vatPayerStatus.registrationAuthority.otherRegistrationAuthorityId` (string) A legacy / historical reference code of a registration authority. Example: "RA000009" - `values.updatedBusinessPartner.profile.hcpProfile` (object) A legal form which contains also contextual information about applied updates. - `values.updatedBusinessPartner.profile.hcpProfile.generalLicense` (object) A legal form which contains also contextual information about applied updates. - `values.updatedBusinessPartner.profile.hcpProfile.generalLicense.professionType` (object) The profession type of the Healthcare Professional. - `values.updatedBusinessPartner.profile.hcpProfile.generalLicense.professionType.name` (string) Name of the profession type. Example: "Doctor" - `values.updatedBusinessPartner.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.updatedBusinessPartner.profile.hcpProfile.generalLicense.professionType.technicalKey` (string) Technical key of the profession type. Example: "DOCTOR" - `values.updatedBusinessPartner.profile.hcpProfile.generalLicense.licenseStatus` (object) The license status of the Healthcare Professional. - `values.updatedBusinessPartner.profile.hcpProfile.generalLicense.licenseStatus.name` (string) Name of the license status. Example: "Granted" - `values.updatedBusinessPartner.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.updatedBusinessPartner.profile.hcpProfile.generalLicense.licenseStatus.technicalKey` (string) Technical key of the license status. Example: "GRANTED" - `values.updatedBusinessPartner.profile.hcpProfile.generalLicense.updateAssessment` (object) Update assessment for hcp profile General License. - `values.updatedBusinessPartner.profile.hcpProfile.generalLicense.updateAssessment.before` (object) The general license of the Healthcare Professional. - `values.updatedBusinessPartner.profile.hcpProfile.operationalPermissions` (array) Operational permissions of the Healthcare Professional. - `values.updatedBusinessPartner.profile.hcpProfile.operationalPermissions.issuingAuthority` (string) The issuing authority of the operational permission. Example: "Swiss Medical Association" - `values.updatedBusinessPartner.profile.hcpProfile.operationalPermissions.permissionStatus` (object) The permission status of the operational permission. - `values.updatedBusinessPartner.profile.hcpProfile.operationalPermissions.permissionStatus.name` (string) Name of the permission status. Example: "Granted" - `values.updatedBusinessPartner.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.updatedBusinessPartner.profile.hcpProfile.operationalPermissions.permissionStatus.technicalKey` (string) Technical key of the permission status. Example: "GRANTED" - `values.updatedBusinessPartner.profile.hcpProfile.operationalPermissions.activityStatus` (object) The activity status of the operational permission. - `values.updatedBusinessPartner.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.updatedBusinessPartner.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.updatedBusinessPartner.profile.hcpProfile.operationalPermissions.activityStatus.technicalKey` (string) Technical key of the activity status. Example: "INACTIVE" - `values.updatedBusinessPartner.profile.hcpProfile.operationalPermissions.practiceLocations` (array) Practice locations of the Healthcare Professional. - `values.updatedBusinessPartner.profile.hcpProfile.operationalPermissions.practiceLocations.practiceName` (string) The practice location of the Healthcare Professional. Example: "VIVOMED AG" - `values.updatedBusinessPartner.profile.hcpProfile.operationalPermissions.practiceLocations.selfDispensationStatus` (object) The self-dispensation status of the Healthcare Professional. - `values.updatedBusinessPartner.profile.hcpProfile.operationalPermissions.practiceLocations.selfDispensationStatus.name` (string) Name of the self-dispensation status. Example: "No" - `values.updatedBusinessPartner.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.updatedBusinessPartner.profile.hcpProfile.operationalPermissions.practiceLocations.selfDispensationStatus.technicalKey` (string) Technical key of the self-dispensation status. Example: "NO" - `values.updatedBusinessPartner.profile.hcpProfile.operationalPermissions.practiceLocations.controlledSubstancePurchasePermission` (object) The controlled substance purchase permission of the Healthcare Professional. - `values.updatedBusinessPartner.profile.hcpProfile.operationalPermissions.practiceLocations.controlledSubstancePurchasePermission.name` (string) Name of the controlled substance purchase permission. Example: "Yes" - `values.updatedBusinessPartner.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.updatedBusinessPartner.profile.hcpProfile.operationalPermissions.practiceLocations.controlledSubstancePurchasePermission.technicalKey` (string) Technical key of the controlled substance purchase permission. Example: "YES" - `values.updatedBusinessPartner.relations` (array) - `values.updatedBusinessPartner.relations.startedAt` (string) Describe when this relationship was first established. Example: "2025-09-10T10:12:36Z" - `values.updatedBusinessPartner.relations.endedAt` (string) Describe when this relationship ended. Example: "2025-09-10T10:12:36Z" - `values.updatedBusinessPartner.relations.type` (object) Provides information about the type of the relationship between two Business Partners like:\ direct parent/child, ultimate parent, branch. - `values.updatedBusinessPartner.relations.type.name` (string) Display name of the Business Partner Relation Type. Example: "Commercial ultimate" - `values.updatedBusinessPartner.relations.type.technicalKey` (string) Technical Key of the Business Partner Relation Type. Example: "COMMERCIAL_ULTIMATE" - `values.updatedBusinessPartner.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.updatedBusinessPartner.relations.class` (object) Provides information about the classification of the relation. - `values.updatedBusinessPartner.relations.class.name` (string) Display name of the Business Partner Relation Class. Example: "CDQ Hierarchy" - `values.updatedBusinessPartner.relations.class.technicalKey` (string) Technical Key of the Business Partner Relation Class. Example: "BUSINESS_PARTNER_RELATION_CLASS_CDQ_HIERARCHY" - `values.updatedBusinessPartner.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.updatedBusinessPartner.relations.startNode` (object) Unique identifiers for Business Partner in the relation - `values.updatedBusinessPartner.relations.startNode.dataSourceId` (string) Unique identifier for a Data Source of the Storage. Example: "648824a691d8d2503d65103e" - `values.updatedBusinessPartner.relations.endNode` (object) Unique identifiers for Business Partner in the relation - `values.updatedBusinessPartner.relations.deactivatedAt` (string) Describe when this relationship was deactivated. Read only. Example: "2025-09-10T10:12:36Z" - `values.updatedBusinessPartner.relations.updateAssessment` (object) Update assessment for a Business Partner relation. - `values.updatedBusinessPartner.relations.updateAssessment.before` (object) Business Partner hierarchy, or any other kind of relation between two Business Partner entities. The data about relationships between companies come from official, external data sources. - `values.updatedBusinessPartner.jsonRecord` (object) A JSON representation of the business partner record. Example: "{\"key\":\"value\"}" - `values.updatedBusinessPartner.externalContext` (object) Represents additional context information that is external to the main Business Partner data. - `values.updatedBusinessPartner.externalContext.identifiers` (array) List of Identifiers. - `values.updatedBusinessPartner.externalContext.identifiers.value` (string) Value of own identifiers of a record. Example: "7250017031" - `values.updatedBusinessPartner.externalContext.identifiers.type` (object) Type of the External Context Identifier. - `values.updatedBusinessPartner.externalContext.identifiers.type.technicalKey` (string) Technical key for the External Context Identifier Type. Example: "KUNNR" - `values.updatedBusinessPartner.externalContext.identifiers.updateAssessment` (object) Update assessment for an external context identifier. - `values.updatedBusinessPartner.externalContext.identifiers.updateAssessment.before` (object) An identifier of the External Context. - `values.storageBusinessPartner` (object) An organization which has some degree of involvement with another organization's business dealings. Typically, a company's business partner is another company in the role of a customer, a supplier, a vendor, or a service provider. In the CDL context, the business partner is the core managed entity. A business partner is globally uniquely identifiable by a CDL ID, and all managed information such as addresses, documents, and hierarchies is linked to a business partner. - `values.storageBusinessPartner.createdAt` (string) Date of creation (ISO 8601-compliant). Example: "2025-09-10T10:12:36Z" - `values.storageBusinessPartner.dataSource` (string) Name or ID of a data source. Reflects the associated external system where the record originates from. Example: "\"CUSTOM_DATA_SOURCE\" or \"648824a691d8d2503d65103e\"" - `values.storageBusinessPartner.disclosed` (boolean) A flag to indicate whether the Business Partner should participate in the sharing or not. If 'true' this Business Partner might be used to create a new entry or update an existing entry in the community pool. Otherwise, it will not be considered for the sharing process. For more details, you can read about [Sharing Scopes](https://developer.cdq.com/reference-docs/data-exchange/V5/tag/Business-Partner-Storages/paths/~1v4~1storages~1%7BstorageId%7D~1sharingscopes/post/). Example: "false" - `values.storageBusinessPartner.updateMonitoring` (boolean) A flag to indicate whether the Business Partner should receive updates from non-commercial Reference Data Sources or not. If 'true' this Business Partner will receive updates since the change from 'false'. If 'false' this Business Partner will not receive any new updates since the change. If not provided, the previous value will not be changed. By default, Update Monitoring is activated. Example: "true" - `values.storageBusinessPartner.updateCommercialMonitoring` (array) Enabling update commercial monitoring has 2 possibilities: * via Data Mapper Definition: include mapping of updateCommercialMonitoring in the Data Mapper Definition * via direct Business Partner model upload: fill complete Business Partner model and . Null/undefined results in protection of this setup from the previous upsert. Empty or filled results in data transition that may link or unlink to / from respective commercial Reference Data Source Note: follow the approach that is currently used in your storage integration. - `values.storageBusinessPartner.updateCommercialMonitoring.type` (object, required) Type of the Business Partner Update Commercial Monitoring. - `values.storageBusinessPartner.updateCommercialMonitoring.type.technicalKey` (string) Name of commercial Reference Data Source that from which the Business Partner should receive updates. Possible values: * [DNB](https://directplus.documentation.dnb.com/openAPI.html?apiID=cmpelkv2) ([wiki](https://meta.cdq.com/Data_source/DNB)) * [DNB_MASTER_DATA_BASIC](https://directplus.documentation.dnb.com/DataBlocks.html?apiID=dataBlocks&blockIDs=companyinfo_L1_v1) ([wiki](https://meta.cdq.com/Data_source/DNB.MASTER.DATA.BASIC)) * [DNB_MASTER_DATA_EXTENDED](https://directplus.documentation.dnb.com/DataBlocks.html?apiID=dataBlocks&blockIDs=companyinfo_L2_v1,principalscontacts_L2_v2,hierarchyconnections_L1_v1) ([wiki](https://meta.cdq.com/Data_source/DNB.MASTER.DATA.EXTENDED)) * [DNB_LINKAGE_LNKELI](https://directplus.documentation.dnb.com/openAPI.html?apiID=lnkeli) ([wiki](https://meta.cdq.com/Data_source/DNB.LINKAGE.LNKELI)) Example: "DNB" - `values.storageBusinessPartner.updateCommercialMonitoring.value` (boolean, required) Value of the Business Partner Update Commercial Monitoring. If 'true', the monitoring of this record will be activated on the commercial data source and this Business Partner will receive updates from that source. If 'false', the monitoring of this record will be deactivated in the commercial data source and this Business Partner will not receive any new updates from that source. By default, Update Commercial Monitoring is NOT activated. Example: "true" - `values.storageBusinessPartner.metadata` (object) Information about results of Business Partner processing. - `values.storageBusinessPartner.metadata.sharingStatus` (object) Business Partner Sharing Statuses. - `values.storageBusinessPartner.metadata.sharingStatus.status` (string) Sharing Status: * - The business partner violates at least one rule for required parameters defined by collaboration linkage strategy so can not be shared. * - The business partner violates at least one rule that leads to an overall data validation result of ERROR, and can not be shared. * - The business partner has missing at least one of required parameters defined by collaboration linkage strategy so can not be shared. * - The record was identified as natural person and is therefore excluded from the sharing. * - As the matching result was uncertain the business partner is currently waiting to be reviewed before it can be shared. * - During the last attempt to share the business partner process issue occurred. This business partner will be processed again. * - No match could be found and therefore the business partner was added to the community pool as a new business partner. * - A confident match was found and therefore the business partner was linked to an existing business partner in the community pool. * - Review decision has been made and the business partner was added to the community pool as a new business partner. * - Review decision has been made and the business partner was linked to an existing business partner in the community pool. * - The business partner will be considered for the sharing process. * - During the last attempt to share the business partner it was marked as 'undisclosed' and for that reason not considered. Example: "SHARED_WITH_NO_MATCH" - `values.storageBusinessPartner.metadata.sharingStatus.description` (string) A description of the sharing status. This is a human-readable description of the sharing status. Example: "UNDER_CONSIDERATION: The business partner will be considered for the sharing process." - `values.storageBusinessPartner.metadata.identityLinks` (array) List of Identity Links. - `values.storageBusinessPartner.metadata.identityLinks.linkId` (string) Unique identifier for the link between the business partner and the sharing pool. Example: "6465f2492bdcd350159a79d6" - `values.storageBusinessPartner.metadata.identityLinks.cdqId` (string) Unique identifier for the Business Partner. Example: "VIES:PL8660001429" - `values.storageBusinessPartner.metadata.identityLinks.addressId` (string) Unique identifier for the address which was used for the linkage in the POOL. Example: "0" - `values.storageBusinessPartner.metadata.identityLinks.externalAddressId` (string) Unique identifier from an external source for the address which was used for the linkage in the POOL. Example: "123456789" - `values.storageBusinessPartner.metadata.logResultStatuses` (array) List of Log Result Statuses. - `values.storageBusinessPartner.metadata.logResultStatuses.processingLogId` (string) Unique identifier of a processing log. Example: "CURATION_LOG" - `values.storageBusinessPartner.metadata.logResultStatuses.triggerProcessedAt` (string) Time when this log result has been processed by trigger. Example: "2025-09-10T10:12:36Z" - `values.storageBusinessPartner.metadata.logResultStatuses.triggerType` (object) Type of processing triggers. - `values.storageBusinessPartner.metadata.logResultStatuses.triggerType.name` (string) Name of processing trigger reason. Example: "CREATED" - `values.storageBusinessPartner.metadata.logResultStatuses.triggerType.technicalKey` (string) Technical Key of the processing trigger reason. Example: "CREATED" - `values.storageBusinessPartner.metadata.logResultStatuses.trigger` (object) Processing trigger reason. - `values.storageBusinessPartner.metadata.logResultStatuses.trigger.processedAt` (string) Time when this log result has been processed by trigger. Example: "2025-09-10T10:12:36Z" - `values.storageBusinessPartner.metadata.logResultStatuses.trigger.provenance` (object) Processing trigger provenance. - `values.storageBusinessPartner.metadata.logResultStatuses.trigger.type` (object) Type of processing triggers. - `values.storageBusinessPartner.metadata.logResultStatuses.jobProcessedAt` (string) Time when this log result has been processed by job. Example: "2025-09-10T10:12:36Z" - `values.storageBusinessPartner.metadata.logResultStatuses.processedAt` (string) Time when this log result has been processed. Example: "2025-09-10T10:12:36Z" - `values.storageBusinessPartner.metadata.logResultStatuses.status` (string) Status of log result. Example: "INFO" - `values.storageBusinessPartner.metadata.logResultStatuses.description` (string) Description of log result. Example: "Validation Level" - `values.storageBusinessPartner.metadata.logResultStatuses.processingStatus` (object) Processing status. - `values.storageBusinessPartner.metadata.logResultStatuses.processingStatus.technicalKey` (string) Possible technical states of processing. Example: "IN_PROGRESS" - `values.storageBusinessPartner.metadata.decisionLogResult` (object) Outcome of a decision-making process based on a decision log. - `values.storageBusinessPartner.metadata.decisionLogResult.reviewStatus` (string) Review status of the Business Partner. Enum: "REVIEWED", "NOT_REVIEWED" - `values.storageBusinessPartner.metadata.decisionLogResult.naturalPersonsReviewStatus` (string) Review status of the Business Partner. Enum: "REVIEWED", "NOT_REVIEWED" - `values.storageBusinessPartner.metadata.decisionLogResult.duplicatesReviewStatus` (string) Review status of the Business Partner. Enum: "REVIEWED", "NOT_REVIEWED" - `values.storageBusinessPartner.record` (string) Stringified JSON of an individual Business Partner record. Characters: backslash and double quote must be escaped (respectively: and ). Fields containing are unallowed. Maximum size: 15MB. Example: "{\"name\": \"BUSINESSPARTNER_NAME\", ...}" - `values.storageBusinessPartner.names` (array) List of names. - `values.storageBusinessPartner.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.storageBusinessPartner.categories` (array) List of Categories. - `values.storageBusinessPartner.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.storageBusinessPartner.profile` (object) Additional documentation can be found [here](https://meta.cdq.com/Partner_profile). - `values.storageBusinessPartner.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.storageBusinessPartner.profile.hcpProfile.generalLicense` (object) The general license of the Healthcare Professional. - `values.storageBusinessPartner.relations` (array) List of Relations. Insert or update Business Partner Relations. Relations that are not listed in the request and start in the current business partner, are marked as INACTIVE. In D&B storages, only not listed relations of class [D&B Hierarchy](https://meta.cdq.com/Business_partner/relation/class/dnb) and one of type [https://meta.cdq.com/Business_partner/relation/type/direct_legal_relation](Direct Legal Relation), [https://meta.cdq.com/Business_partner/relation/type/domestic_legal_ultimate_relation](Domestic Legal Ultimate Relation) or [https://meta.cdq.com/Business_partner/relation/type/global_legal_ultimate_relation](Global Legal Ultimate Relation), are marked as INACTIVE. - `values.storageBusinessPartner.types` (array) List of Types. - `values.storageBusinessPartner.types.name` (string) Display name of the Business Partner Type Name. Example: "Legal Entity" - `values.storageBusinessPartner.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.storageBusinessPartner.types.technicalKey` (string) Technical key of the Business Partner Type. Example: "LEGAL_ENTITY" - `values.storageBusinessPartner.addresses` (array) List of Addresses. - `values.storageBusinessPartner.addresses.id` (string) ID of the address. Example: "0001" - `values.storageBusinessPartner.addresses.cdqId` (string) CDQ ID of an address. Example: "CDQID-123456789" - `values.storageBusinessPartner.addresses.contexts` (array) List of Address Contexts. - `values.storageBusinessPartner.addresses.administrativeAreas` (array) List of Administrative Areas. - `values.storageBusinessPartner.addresses.postCodes` (array) List of Post Codes. - `values.storageBusinessPartner.addresses.localities` (array) List of Localities. - `values.storageBusinessPartner.addresses.thoroughfares` (array) List of Thoroughfares. - `values.storageBusinessPartner.addresses.premises` (array) List of Premises. - `values.storageBusinessPartner.addresses.postalDeliveryPoints` (array) List of Postal Delivery Points. - `values.storageBusinessPartner.addresses.geographicCoordinates` (object) Decimal geographic coordinates (WGS 84 - reference coordinate system). - `values.storageBusinessPartner.bankAccounts` (array) List of Bank Accounts. - `values.storageBusinessPartner.bankAccounts.internationalBankAccountIdentifier` (string) The IBAN of a bank account. Example: "CH8800781619278412000" - `values.storageBusinessPartner.bankAccounts.internationalBankIdentifier` (string) (BIC/SWIFT) Bank identifier which is globally unique. Example: "KBSGCH22XXX" - `values.storageBusinessPartner.bankAccounts.nationalBankAccountIdentifier` (string) Identifier of a bank account in a national context, i.e. for a country. Example: "619278412000" - `values.storageBusinessPartner.bankAccounts.nationalBankIdentifier` (string) Bank identifier which is unique in a national context, i.e. for a country. Example: "00781" - `values.storageBusinessPartner.bankAccounts.countryCode` (string) ISO code to identify the country a bank account is registered in. Example: "DE" - `values.storageBusinessPartner.bankAccounts.vendorPaymentSummary` (object) Vendor Payment Summary. - `values.storageBusinessPartner.bankAccounts.vendorPaymentSummary.firstPaymentDate` (string) The date of the first payment to the bank account (ISO 8601-compliant). Example: "2025-09-10T10:12:36Z" - `values.storageBusinessPartner.bankAccounts.vendorPaymentSummary.lastPaymentDate` (string) The date of the last payment to the bank account (ISO 8601-compliant). Example: "2025-09-10T10:12:36Z" - `values.storageBusinessPartner.bankAccounts.vendorPaymentSummary.numberOfPayments` (integer) The number of payments to the bank account. Example: "1" ## Response 400 fields (application/json): - `status` (object) Details about status or error of a service - `status.code` (integer) RFC 7231 status code for this error. Example: "400" - `status.technicalKey` (string) Technical key describing the status or error Example: "OK" - `status.details` (array) - `status.details.id` (integer, required) 9-digit code which is uniquely identifying a message Example: 200000004 - `status.details.message` (string, required) Human-readable message which may also be presented in user interface. Example: "Business Partner Name is mandatory." - `status.details.technicalKey` (string) Technical key to uniquely identify a message. Example: "JOB_FINISHED" - `status.details.jsonPath` (string) JSONPath as specified by the IETF standard Example: "$.businessPartner.names[0].value" - `status.details.jsonRecord` (string) Object provided in plain JSON format. Example: "{ \"key\" : \"value\"}" - `status.path` (string) Requested path which caused this error. Example: "/v2/businesspartners/lookup" - `status.timestamp` (string) ISO 8601 representation of the timestamp. Example: "2025-09-10T10:12:36Z"