# List Links Reads a page of links of the Business Partners starting from the 'startAfter' and with a size of 'limit'. Endpoint: GET /v4/businesspartners/identitylinks Version: 5 Security: apiKey ## 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" - `storageId` (string, required) Unique identifier of the Storage. Example: "72d6900fce6b326088f5d9d91049e3e6" - `referenceDataSource` (array) Reference data source as ALEI prefix of the linked Business Partner. Example: ["CDQ.POOL"] - `businessPartnerId` (array) Business Partner IDs which should be filtered. Example: ["63e635235c06b7396330fe40"] - `externalId` (array) Business Partner externalIDs. Example: ["The ID managed in the customer's SAP systems."] - `dataSourceId` (array) Filter by specified Data Source ID. Example: ["648824a691d8d2503d65103e"] - `cdqIds` (array) CDQ IDs which should be filtered. Example: ["VIES:PL8660001429"] - `featuresOn` (array) Features to be activated. Enum: "ACCEPT_REPLICATION_DELAYS", "NUMBER_OF_TOTAL" - `featuresOff` (array) Features to be deactivated. Enum: "ACCEPT_REPLICATION_DELAYS", "NUMBER_OF_TOTAL" ## Response 200 fields (application/json): - `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" - `limit` (integer) Number of items per page. Example: "100" - `total` (integer) Total number of items which can be paged. Example: "67" - `values` (array) List of Business Partner Identity Links. - `values.id` (string) Unique identifier of the linkage. Example: "CDQ.POOL:5E580DD08E8B454820E8F67E0" - `values.createdAt` (string) Date of creation (ISO 8601-compliant). Example: "2025-09-10T10:12:36Z" - `values.organization` (string) Uniquely identifying ID of the organization. Example: "cdq_monitor" - `values.storageId` (string) Unique identifier of the Storage. Example: "72d6900fce6b326088f5d9d91049e3e6" - `values.businessPartnerId` (string) A CDQ ID identifies a business partner uniquely in the context of the Corporate Data League. Example: "63e635235c06b7396330fe40" - `values.referenceBusinessPartnerId` (string) ID of monitored Business Partner within own Storage. Null for reference Data Sources like VIES, LEI. Example: "VIES:ATU12345678" - `values.addressId` (string) Unique identifier for the address which was used for the linkage in the POOL. Example: "0" - `values.addressVersion` (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.addressVersion.languageTechnicalKey` (string) ISO 639-1 two-letter code of languages. Example: "DE" - `values.addressVersion.characterSetTechnicalKey` (string) Technical key of character set. Supported character sets can be found [here](https://meta.cdq.com/Address/version/character_set). Example: "INTERNATIONAL" - `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.externalAddressId` (string) ID the address has in the external system where the record originates from. Example: "1" - `values.referenceAddressVersion` (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.cdqId` (string) Unique identifier for the Business Partner. Example: "VIES:PL8660001429" - `values.linkageParameter` (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.linkageParameter.id` (string) A CDQ ID identifies a business partner uniquely in the context of the Corporate Data League. Example: "63e635235c06b7396330fe40" - `values.linkageParameter.modifiedAt` (string) Date of modification (ISO 8601-compliant). Example: "2025-09-10T10:12:36Z" - `values.linkageParameter.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.linkageParameter.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.linkageParameter.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.linkageParameter.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.linkageParameter.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.linkageParameter.updateCommercialMonitoring.type` (object, required) Type of the Business Partner Update Commercial Monitoring. - `values.linkageParameter.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.linkageParameter.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.linkageParameter.metadata` (object) Information about results of Business Partner processing. - `values.linkageParameter.metadata.sharingStatus` (object) Business Partner Sharing Statuses. - `values.linkageParameter.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.linkageParameter.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.linkageParameter.metadata.identityLinks` (array) List of Identity Links. - `values.linkageParameter.metadata.identityLinks.linkId` (string) Unique identifier for the link between the business partner and the sharing pool. Example: "6465f2492bdcd350159a79d6" - `values.linkageParameter.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.linkageParameter.metadata.logResultStatuses` (array) List of Log Result Statuses. - `values.linkageParameter.metadata.logResultStatuses.processingLogId` (string) Unique identifier of a processing log. Example: "CURATION_LOG" - `values.linkageParameter.metadata.logResultStatuses.triggerProcessedAt` (string) Time when this log result has been processed by trigger. Example: "2025-09-10T10:12:36Z" - `values.linkageParameter.metadata.logResultStatuses.triggerType` (object) Type of processing triggers. - `values.linkageParameter.metadata.logResultStatuses.triggerType.name` (string) Name of processing trigger reason. Example: "CREATED" - `values.linkageParameter.metadata.logResultStatuses.triggerType.technicalKey` (string) Technical Key of the processing trigger reason. Example: "CREATED" - `values.linkageParameter.metadata.logResultStatuses.trigger` (object) Processing trigger reason. - `values.linkageParameter.metadata.logResultStatuses.trigger.processedAt` (string) Time when this log result has been processed by trigger. Example: "2025-09-10T10:12:36Z" - `values.linkageParameter.metadata.logResultStatuses.trigger.provenance` (object) Processing trigger provenance. - `values.linkageParameter.metadata.logResultStatuses.trigger.provenance.name` (string) Display Name of the Provenance Name. Example: "VIES" - `values.linkageParameter.metadata.logResultStatuses.trigger.provenance.technicalKey` (string) Technical Key of the Provenance Name. Example: "VIES" - `values.linkageParameter.metadata.logResultStatuses.trigger.provenance.cdqId` (string) The ID provided for a linkage with the source by CDQ. Example: "VIES:PL8660001429" - `values.linkageParameter.metadata.logResultStatuses.trigger.type` (object) Type of processing triggers. - `values.linkageParameter.metadata.logResultStatuses.jobProcessedAt` (string) Time when this log result has been processed by job. Example: "2025-09-10T10:12:36Z" - `values.linkageParameter.metadata.logResultStatuses.processedAt` (string) Time when this log result has been processed. Example: "2025-09-10T10:12:36Z" - `values.linkageParameter.metadata.logResultStatuses.status` (string) Status of log result. Example: "INFO" - `values.linkageParameter.metadata.logResultStatuses.description` (string) Description of log result. Example: "Validation Level" - `values.linkageParameter.metadata.logResultStatuses.processingStatus` (object) Processing status. - `values.linkageParameter.metadata.logResultStatuses.processingStatus.technicalKey` (string) Possible technical states of processing. Example: "IN_PROGRESS" - `values.linkageParameter.metadata.decisionLogResult` (object) Outcome of a decision-making process based on a decision log. - `values.linkageParameter.metadata.decisionLogResult.reviewStatus` (string) Review status of the Business Partner. Enum: "REVIEWED", "NOT_REVIEWED" - `values.linkageParameter.metadata.decisionLogResult.naturalPersonsReviewStatus` (string) Review status of the Business Partner. Enum: "REVIEWED", "NOT_REVIEWED" - `values.linkageParameter.metadata.decisionLogResult.duplicatesReviewStatus` (string) Review status of the Business Partner. Enum: "REVIEWED", "NOT_REVIEWED" - `values.linkageParameter.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.linkageParameter.names` (array) List of names. - `values.linkageParameter.names.type` (object) The type of the name, e.g. a locally used name or an international version. - `values.linkageParameter.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.linkageParameter.names.type.name` (string) Display label for the Name Type. Example: "Local Name" - `values.linkageParameter.names.type.technicalKey` (string) Technical Keys of the Name Type. Example: "LOCAL" - `values.linkageParameter.names.value` (string) The actual name. Example: "Corporate Data Quality AG" - `values.linkageParameter.names.shortName` (string) The abbreviated variant of a company's full name. Example: "CDQ AG" - `values.linkageParameter.names.language` (object) Naming of a language according to ISO 639-1. - `values.linkageParameter.names.language.name` (string) ISO 639-1 name of language. Example: "German" - `values.linkageParameter.names.language.technicalKey` (string) ISO 639-1 two-letter code of languages. Example: "DE" - `values.linkageParameter.names.details` (array) - `values.linkageParameter.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.linkageParameter.names.details.type` (object) Type of additional information to a [Business Partner Name](https://meta.cdq.com/Business_partner/name). - `values.linkageParameter.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.linkageParameter.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.linkageParameter.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.linkageParameter.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.linkageParameter.legalForm.name` (string) Display of the Legal Form. Example: "Aktiengesellschaft" - `values.linkageParameter.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.linkageParameter.legalForm.technicalKey` (string) Technical Key of a Legal Form. Descriptions of below enums contain , and . Example: "DE_9866" - `values.linkageParameter.legalForm.mainAbbreviation` (string) The primary abbreviation of a legal form, i.e. the most commonly used abbreviation in a country. Example: "AG" - `values.linkageParameter.legalForm.categories` (array) List of Legal Form Categories. - `values.linkageParameter.legalForm.categories.name` (string) Descriptive display name of the Legal Form Category. Example: "Limited Liability Company" - `values.linkageParameter.legalForm.categories.shortName` (string) Short display name of the Legal Form Category. Example: "LLC" - `values.linkageParameter.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.linkageParameter.legalForm.categories.technicalKey` (string) Technical Key of the [Legal Form Category](https://meta.cdq.com/Business_partner/legal_form/category). Example: "LIMITED" - `values.linkageParameter.identifiers` (array) List of Identifiers. - `values.linkageParameter.identifiers.type` (object) Type of the identifier. - `values.linkageParameter.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.linkageParameter.identifiers.type.name` (string) Display label for the Identifier. Example: "CH_VAT_ID" - `values.linkageParameter.identifiers.type.technicalKey` (string) Technical key of the type of the Identifier. Example: "CH_VAT_ID" - `values.linkageParameter.identifiers.value` (string) Value of the identifier. Example: "CHE-218.608.886 HR/MWST" - `values.linkageParameter.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.linkageParameter.identifiers.issuingBody.name` (string) Preferred display label for an Issuing Body. Example: "Amtsgericht Aachen" - `values.linkageParameter.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.linkageParameter.identifiers.issuingBody.technicalKey` (string) Technical key of the Issuing Body. Example: "Amtsgericht Aachen" - `values.linkageParameter.identifiers.issuingBody.jurisdiction` (object) The authority of an official organization to make decisions and judgments in a particular administrative area. - `values.linkageParameter.identifiers.issuingBody.jurisdiction.country` (object) Country consisting of the country name and country code (ISO 3166-1 alpha-2). - `values.linkageParameter.identifiers.issuingBody.jurisdiction.country.shortName` (string) Country code (ISO 3166-1 alpha-2). Example: "CH" - `values.linkageParameter.identifiers.issuingBody.jurisdiction.country.value` (string) Country name (ISO 3166-1 alpha-2). Example: "Switzerland" - `values.linkageParameter.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.linkageParameter.identifiers.status.name` (string) Display label for the Identifier Status Name. Example: "ACTIVE" - `values.linkageParameter.identifiers.status.technicalKey` (string) Technical key of the Identifier Status. Example: "ACTIVE" - `values.linkageParameter.categories` (array) List of Categories. - `values.linkageParameter.categories.name` (string) Display name of the Business Partner Category Name. Example: "Hotel" - `values.linkageParameter.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.linkageParameter.categories.technicalKey` (string) Technical Key of the Business Partner Category. Example: "HOTEL" - `values.linkageParameter.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.linkageParameter.status.type` (object) The standardized status which the business partner currently has. - `values.linkageParameter.status.type.name` (string) Display name of the Business Partner Status. Example: "In Liquidation" - `values.linkageParameter.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.linkageParameter.status.type.technicalKey` (string) Technical Key of the Business Parter Status. Example: "IN_LIQUIDATION" - `values.linkageParameter.status.officialDenotation` (string) The status as provided by an official register. Example: "Good Standing" - `values.linkageParameter.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.linkageParameter.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.linkageParameter.profile` (object) Additional documentation can be found [here](https://meta.cdq.com/Partner_profile). - `values.linkageParameter.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.linkageParameter.profile.minorityIndicator.value` (string) The actual value of the minority indicator, representing the minority group. Example: "Social enterprise" - `values.linkageParameter.profile.classifications` (array) List of Classifications. - `values.linkageParameter.profile.classifications.value` (string) A textual description of the Classification. Example: "Manufacture of pesticides and other agrochemical products." - `values.linkageParameter.profile.classifications.code` (string) Code that classifies the business partner. Example: "20.20Z" - `values.linkageParameter.profile.classifications.type` (object) Type of classification such as NACE, SIC, NAF or other industry classification standards. - `values.linkageParameter.profile.classifications.type.name` (string) Display label for the Classification Type. Example: "NAF 2003" - `values.linkageParameter.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.linkageParameter.profile.classifications.type.technicalKey` (string) TechnicalKey for the Classification Type. Example: "NAF 2003" - `values.linkageParameter.profile.phoneNumbers` (array) List of Phone Numbers. - `values.linkageParameter.profile.phoneNumbers.countryPrefix` (string) The country prefix of a phone number. Example: "+41" - `values.linkageParameter.profile.phoneNumbers.number` (string) The complete phone number without any country prefixes. Example: "71 571 10 40" - `values.linkageParameter.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.linkageParameter.profile.phoneNumbers.type.name` (string) Display label for a Phone Number Type Name. Example: "FAX" - `values.linkageParameter.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.linkageParameter.profile.phoneNumbers.type.technicalKey` (string) Technical Keys of the PhoneNumber. Example: "FAX" - `values.linkageParameter.profile.phoneNumbers.value` (string) The actual complete phone number incl. country prefix. Example: "+41 71 571 10 40" - `values.linkageParameter.profile.websites` (array) List of Websites. - `values.linkageParameter.profile.websites.url` (string) The actual company website URL. Example: "https://cdq.com" - `values.linkageParameter.profile.websites.type` (object) Describes the type of website of a business partner, e.g. corporate website, official LinkedIn profile, etc. - `values.linkageParameter.profile.websites.type.name` (string) Display label for a Website Type Name Example: "Corporate Website" - `values.linkageParameter.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.linkageParameter.profile.websites.type.technicalKey` (string) Technical Keys of the Website Type Name. Example: "WEBSITE_TYPE_CORPORATE" - `values.linkageParameter.profile.contactEmails` (array) List of Contact Emails. - `values.linkageParameter.profile.contactEmails.value` (string) Value of the email address of the Business Partner. Example: "developer-portal@cdq.com" - `values.linkageParameter.profile.tags` (array) List of Tags. - `values.linkageParameter.profile.tags.value` (string) Value of the tag. Example: "Warehouse" - `values.linkageParameter.profile.tags.type` (object) A type that specifies the nature of the tag. - `values.linkageParameter.profile.tags.type.technicalKey` (string, required) Technical Key of the Tag. Example: "WAREHOUSE" - `values.linkageParameter.profile.vatPayerStatus` (object) Shows whether the Business Partner is a VAT payer. - `values.linkageParameter.profile.vatPayerStatus.publicationDate` (string) Date of publication Example: "2025-09-10T10:12:36Z" - `values.linkageParameter.profile.vatPayerStatus.status` (object) Payer Status. - `values.linkageParameter.profile.vatPayerStatus.status.name` (string) Name of Vat payer status. Available values RELIABLE and UNRELIABLE Example: "RELIABLE" - `values.linkageParameter.profile.vatPayerStatus.status.technicalKey` (string) Technical key of Vat payer status Example: "VAT_PAYER_STATUS" - `values.linkageParameter.profile.vatPayerStatus.registrationAuthority` (object) Shows the registration authority of the Business Partner. - `values.linkageParameter.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.linkageParameter.profile.vatPayerStatus.registrationAuthority.registrationAuthorityEntityId` (string) The identifier of the Entity at the indicated registration authority. Example: "RA000009" - `values.linkageParameter.profile.vatPayerStatus.registrationAuthority.otherRegistrationAuthorityId` (string) A legacy / historical reference code of a registration authority. Example: "RA000009" - `values.linkageParameter.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.linkageParameter.profile.hcpProfile.generalLicense` (object) The general license of the Healthcare Professional. - `values.linkageParameter.profile.hcpProfile.generalLicense.professionType` (object) The profession type of the Healthcare Professional. - `values.linkageParameter.profile.hcpProfile.generalLicense.professionType.name` (string) Name of the profession type. Example: "Doctor" - `values.linkageParameter.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.linkageParameter.profile.hcpProfile.generalLicense.professionType.technicalKey` (string) Technical key of the profession type. Example: "DOCTOR" - `values.linkageParameter.profile.hcpProfile.generalLicense.licenseStatus` (object) The license status of the Healthcare Professional. - `values.linkageParameter.profile.hcpProfile.generalLicense.licenseStatus.name` (string) Name of the license status. Example: "Granted" - `values.linkageParameter.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.linkageParameter.profile.hcpProfile.generalLicense.licenseStatus.technicalKey` (string) Technical key of the license status. Example: "GRANTED" - `values.linkageParameter.profile.hcpProfile.operationalPermissions` (array) Operational permissions of the Healthcare Professional. - `values.linkageParameter.profile.hcpProfile.operationalPermissions.issuingAuthority` (string) The issuing authority of the operational permission. Example: "Swiss Medical Association" - `values.linkageParameter.profile.hcpProfile.operationalPermissions.permissionStatus` (object) The permission status of the operational permission. - `values.linkageParameter.profile.hcpProfile.operationalPermissions.permissionStatus.name` (string) Name of the permission status. Example: "Granted" - `values.linkageParameter.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.linkageParameter.profile.hcpProfile.operationalPermissions.permissionStatus.technicalKey` (string) Technical key of the permission status. Example: "GRANTED" - `values.linkageParameter.profile.hcpProfile.operationalPermissions.activityStatus` (object) The activity status of the operational permission. - `values.linkageParameter.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.linkageParameter.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.linkageParameter.profile.hcpProfile.operationalPermissions.activityStatus.technicalKey` (string) Technical key of the activity status. Example: "INACTIVE" - `values.linkageParameter.profile.hcpProfile.operationalPermissions.practiceLocations` (array) Practice locations of the Healthcare Professional. - `values.linkageParameter.profile.hcpProfile.operationalPermissions.practiceLocations.practiceName` (string) The practice location of the Healthcare Professional. Example: "VIVOMED AG" - `values.linkageParameter.profile.hcpProfile.operationalPermissions.practiceLocations.selfDispensationStatus` (object) The self-dispensation status of the Healthcare Professional. - `values.linkageParameter.profile.hcpProfile.operationalPermissions.practiceLocations.selfDispensationStatus.name` (string) Name of the self-dispensation status. Example: "No" - `values.linkageParameter.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.linkageParameter.profile.hcpProfile.operationalPermissions.practiceLocations.selfDispensationStatus.technicalKey` (string) Technical key of the self-dispensation status. Example: "NO" - `values.linkageParameter.profile.hcpProfile.operationalPermissions.practiceLocations.controlledSubstancePurchasePermission` (object) The controlled substance purchase permission of the Healthcare Professional. - `values.linkageParameter.profile.hcpProfile.operationalPermissions.practiceLocations.controlledSubstancePurchasePermission.name` (string) Name of the controlled substance purchase permission. Example: "Yes" - `values.linkageParameter.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.linkageParameter.profile.hcpProfile.operationalPermissions.practiceLocations.controlledSubstancePurchasePermission.technicalKey` (string) Technical key of the controlled substance purchase permission. Example: "YES" - `values.linkageParameter.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.linkageParameter.relations.startedAt` (string) Describe when this relationship was first established. Example: "2025-09-10T10:12:36Z" - `values.linkageParameter.relations.endedAt` (string) Describe when this relationship ended. Example: "2025-09-10T10:12:36Z" - `values.linkageParameter.relations.type` (object) Provides information about the type of the relationship between two Business Partners like:\ direct parent/child, ultimate parent, branch. - `values.linkageParameter.relations.type.name` (string) Display name of the Business Partner Relation Type. Example: "Commercial ultimate" - `values.linkageParameter.relations.type.technicalKey` (string) Technical Key of the Business Partner Relation Type. Example: "COMMERCIAL_ULTIMATE" - `values.linkageParameter.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.linkageParameter.relations.class` (object) Provides information about the classification of the relation. - `values.linkageParameter.relations.class.name` (string) Display name of the Business Partner Relation Class. Example: "CDQ Hierarchy" - `values.linkageParameter.relations.class.technicalKey` (string) Technical Key of the Business Partner Relation Class. Example: "BUSINESS_PARTNER_RELATION_CLASS_CDQ_HIERARCHY" - `values.linkageParameter.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.linkageParameter.relations.startNode` (object) Unique identifiers for Business Partner in the relation - `values.linkageParameter.relations.startNode.dataSourceId` (string) Unique identifier for a Data Source of the Storage. Example: "648824a691d8d2503d65103e" - `values.linkageParameter.relations.endNode` (object) Unique identifiers for Business Partner in the relation - `values.linkageParameter.relations.deactivatedAt` (string) Describe when this relationship was deactivated. Read only. Example: "2025-09-10T10:12:36Z" - `values.linkageParameter.types` (array) List of Types. - `values.linkageParameter.types.name` (string) Display name of the Business Partner Type Name. Example: "Legal Entity" - `values.linkageParameter.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.linkageParameter.types.technicalKey` (string) Technical key of the Business Partner Type. Example: "LEGAL_ENTITY" - `values.linkageParameter.addresses` (array) List of Addresses. - `values.linkageParameter.addresses.id` (string) ID of the address. Example: "0001" - `values.linkageParameter.addresses.externalId` (string) ID the address has in the external system where the record originates from. Example: "1" - `values.linkageParameter.addresses.cdqId` (string) CDQ ID of an address. Example: "CDQID-123456789" - `values.linkageParameter.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.linkageParameter.addresses.version.characterSet` (object) Character set. Available values can be found [here](https://meta.cdq.com/Address/version/character_set). - `values.linkageParameter.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.linkageParameter.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.linkageParameter.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.linkageParameter.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.linkageParameter.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.linkageParameter.addresses.careOf.value` (string) Value of the CareOf. Example: "CDQ GmbH c/o Product Department" - `values.linkageParameter.addresses.contexts` (array) List of Address Contexts. - `values.linkageParameter.addresses.contexts.value` (string) Value of the Address Context. Example: "Production hall 7, Storage field 8." - `values.linkageParameter.addresses.administrativeAreas` (array) List of Administrative Areas. - `values.linkageParameter.addresses.administrativeAreas.value` (string) Name of the [Administrative Area](https://meta.cdq.com/Address/administrative_area). Example: "Sankt Gallen" - `values.linkageParameter.addresses.administrativeAreas.shortName` (string) Abbreviation for the [Administrative Area](https://meta.cdq.com/Address/administrative_area). Example: "SG" - `values.linkageParameter.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.linkageParameter.addresses.administrativeAreas.type` (object) Type of the [Administrative Area](https://meta.cdq.com/Address/administrative_area). - `values.linkageParameter.addresses.administrativeAreas.type.name` (string) Display label for the Administrative Area Type. Example: "COUNTY" - `values.linkageParameter.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.linkageParameter.addresses.administrativeAreas.type.technicalKey` (string) Technical key of the Administrative Area. Example: "COUNTY" - `values.linkageParameter.addresses.postCodes` (array) List of Post Codes. - `values.linkageParameter.addresses.postCodes.value` (string) Effective [post code](https://meta.cdq.com/Address/post_code). Example: "9000" - `values.linkageParameter.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.linkageParameter.addresses.postCodes.type.name` (string) Display label for the Post Code Type. Example: "Regular" - `values.linkageParameter.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.linkageParameter.addresses.postCodes.type.technicalKey` (string) Technical key of the Post Code. Example: "REGULAR" - `values.linkageParameter.addresses.localities` (array) List of Localities. - `values.linkageParameter.addresses.localities.type` (object) Type of the [Locality](https://meta.cdq.com/Address/locality). - `values.linkageParameter.addresses.localities.type.name` (string) Display label for the Locality Type. Example: "City" - `values.linkageParameter.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.linkageParameter.addresses.localities.type.technicalKey` (string) Technical Key of the Locality Type. Example: "CITY" - `values.linkageParameter.addresses.localities.shortName` (string) Abbreviation of the [Locality](https://meta.cdq.com/Address/locality). Example: "St. Gallen" - `values.linkageParameter.addresses.localities.value` (string) Name of the [Locality](https://meta.cdq.com/Address/locality). Example: "Sankt Gallen" - `values.linkageParameter.addresses.thoroughfares` (array) List of Thoroughfares. - `values.linkageParameter.addresses.thoroughfares.type` (object) Type of the [Thoroughfare](https://meta.cdq.com/Address/thoroughfare). - `values.linkageParameter.addresses.thoroughfares.type.name` (string) Display label for the Thoroughfare Type Name. Example: "Industrial zone" - `values.linkageParameter.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.linkageParameter.addresses.thoroughfares.type.technicalKey` (string) Technical key of the Thoroughfare Type. Example: "INDUSTRIAL_ZONE" - `values.linkageParameter.addresses.thoroughfares.shortName` (string) Abbreviation of the [Thoroughfare](https://meta.cdq.com/Address/thoroughfare). Example: "Lukasstr. 4" - `values.linkageParameter.addresses.thoroughfares.number` (string) Number of the [Thoroughfare](https://meta.cdq.com/Address/thoroughfare). Example: "4" - `values.linkageParameter.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.linkageParameter.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.linkageParameter.addresses.thoroughfares.direction` (string) Direction of the [Thoroughfare](https://meta.cdq.com/Address/thoroughfare). Example: "221-bis Baker Street, North" - `values.linkageParameter.addresses.premises` (array) List of Premises. - `values.linkageParameter.addresses.premises.value` (string) The actual value of a Premise in the language of the address. Example: "Lukasstraße 4" - `values.linkageParameter.addresses.premises.shortName` (string) Abbreviation of the Premise. Example: "Lukasstr. 4" - `values.linkageParameter.addresses.premises.number` (string) Number of the Premise. Example: "4" - `values.linkageParameter.addresses.premises.type` (object) Type of the Premise. - `values.linkageParameter.addresses.premises.type.name` (string) Display label for the Premise Type. Example: "Factory" - `values.linkageParameter.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.linkageParameter.addresses.premises.type.technicalKey` (string) Technical key of the Premise Type. Example: "FACTORY" - `values.linkageParameter.addresses.postalDeliveryPoints` (array) List of Postal Delivery Points. - `values.linkageParameter.addresses.postalDeliveryPoints.type` (object) A single mailbox or other place at which postal mail is delivered. - `values.linkageParameter.addresses.postalDeliveryPoints.type.name` (string) Display label for the Postal Delivery Point Type. Example: "Mailbox" - `values.linkageParameter.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.linkageParameter.addresses.postalDeliveryPoints.type.technicalKey` (string) Technical key of the Postal Delivery Point. Example: "MAILBOX" - `values.linkageParameter.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.linkageParameter.addresses.postalDeliveryPoints.number` (string) Number of the [Postal Delivery Point](https://meta.cdq.com/Address/postal_delivery_point). Example: "460" - `values.linkageParameter.addresses.postalDeliveryPoints.value` (string) Value of the [Postal Delivery Point](https://meta.cdq.com/Address/postal_delivery_point). Example: "Postfach" - `values.linkageParameter.addresses.geographicCoordinates` (object) Decimal geographic coordinates (WGS 84 - reference coordinate system). - `values.linkageParameter.addresses.geographicCoordinates.latitude` (number) Plain on the earth's surface north or south of the equator. Example: "47.439549" - `values.linkageParameter.addresses.geographicCoordinates.longitude` (number) Plain on the earth's surface east or west of a meridian. Example: "9.395275" - `values.linkageParameter.bankAccounts` (array) List of Bank Accounts. - `values.linkageParameter.bankAccounts.internationalBankAccountIdentifier` (string) The IBAN of a bank account. Example: "CH8800781619278412000" - `values.linkageParameter.bankAccounts.internationalBankIdentifier` (string) (BIC/SWIFT) Bank identifier which is globally unique. Example: "KBSGCH22XXX" - `values.linkageParameter.bankAccounts.nationalBankAccountIdentifier` (string) Identifier of a bank account in a national context, i.e. for a country. Example: "619278412000" - `values.linkageParameter.bankAccounts.nationalBankIdentifier` (string) Bank identifier which is unique in a national context, i.e. for a country. Example: "00781" - `values.linkageParameter.bankAccounts.countryCode` (string) ISO code to identify the country a bank account is registered in. Example: "DE" - `values.linkageParameter.bankAccounts.vendorPaymentSummary` (object) Vendor Payment Summary. - `values.linkageParameter.bankAccounts.vendorPaymentSummary.firstPaymentDate` (string) The date of the first payment to the bank account (ISO 8601-compliant). Example: "2025-09-10T10:12:36Z" - `values.linkageParameter.bankAccounts.vendorPaymentSummary.lastPaymentDate` (string) The date of the last payment to the bank account (ISO 8601-compliant). Example: "2025-09-10T10:12:36Z" - `values.linkageParameter.bankAccounts.vendorPaymentSummary.numberOfPayments` (integer) The number of payments to the bank account. Example: "1" - `values.linkageParameter.externalContext` (object) Represents additional context information that is external to the main Business Partner data. - `values.linkageStatus` (string) Status of the linkage: * SUCCESSFULLY_LINKED - Country and identifier exists, result found by lookup and contains cdqId. Link created. * MISSING_INFORMATION_FOR_LINKAGE - Missing country or information for linkage strategy. * NO_MATCH_FOUND - No result from lookup. * NO_CONFIDENT_MATCH_FOUND - No confident result from lookup. * NO_MATCH_ADDRESS_VERSION - Result found in lookup but address version doesn’t match. * UNDER_CONSIDERATION - Linkage is under consideration. * PROCESS_ISSUE - Internal issues or issues with reference data sources. * QUOTA_LIMIT - The customer doesn’t have enough quota. * INACTIVE_SOURCE - Reference Data source is not activated for the organization or credentials are not provided. * ERRONEOUS_IDENTIFIER - Business Partner didn’t pass the validation due to an incorrect identifier. * EXTERNAL_SERVICE_NOT_AVAILABLE - Lookup would succeed if external service was available. Example: "SUCCESSFULLY_LINKED" - `values.status` (object) Details about status or error of a service - `values.referenceDataSource` (string) Data Source of the Business Partner which was used for the linkage in the POOL. Example: "VIES" - `values.storageDataSource` (object) Data Source of the Business Partner which was used for the linkage in the POOL. - `values.storageDataSource.id` (string) Unique identifier for a Data Source of the Storage. Example: "648824a691d8d2503d65103e"