# Generate Golden Record

Generate a Golden Record from a list of provided Business Partners.

Endpoint: POST /v2/businesspartners/goldenrecords/generate
Version: 3
Security: apiKey

## Request fields (application/json):

  - `countryShortName` (string)
    Country code (ISO 3166-1 alpha-2).
    Example: "CH"

  - `profile` (string)
    Provide configurations with varying feature sets to cater to Golden Record Generation needs.
    Enum: "STANDARD", "QUICK"

  - `featuresOn` (array)
    List of Golden Record Features to be activated.
    Enum: "ACTIVATE_DATASOURCE_BVD", "ACTIVATE_DATASOURCE_DNB", "GOLDENRECORD_CONFIRM_MODE", "SKIP_CANDIDATE_SELECTION"

  - `featuresOff` (array)
    List of Golden Record Features to be deactivated.
    Enum: "ACTIVATE_DATASOURCE_BVD", "ACTIVATE_DATASOURCE_DNB", "GOLDENRECORD_CONFIRM_MODE", "SKIP_CANDIDATE_SELECTION"

  - `dataSources` (array)
    Data sources enabled for identifiers enrichment in golden record
    Enum: "AR_NRC", "AT_CR", "AT_FON", "AU_BR", "BE_CCD", "BR_RF", "BZST", "CA_CR", "CZ_REE", "CDL", "CDQ_POOL", "CDQ_CRAWLED", "CH_CR", "CH_UIDR", "DATAMIRROR", "DE_RC", "DNB", "DNB_LNKELI", "DNB_MASTER_DATA_BASIC", "DNB_MASTER_DATA_EXTENDED", "EE_CR", "FR_RC", "GB_EAW_CR", "GOOGLEPLACES", "IE_CR", "IL_CR", "JP_CR", "LEI", "MX_SBI", "NL_BR", "PL_NOBR", "US_SEC", "US_AK_BER", "US_FL_BER", "US_LA_BER", "US_SF_BER", "US_NY_BER", "US_IO_BER", "US_OR_BER", "US_WA_BER", "US_WY_BER", "US_CO_BER", "SG_BR", "VIES", "DK_CR", "NO_RBE", "LV_CR", "NZ_CR", "SPOR_OMS", "UK_VAT"

  - `configurationId` (string)
    Configuration ID for the Golden Record Generation.
    Example: "12ed4bd757f8e162f8aa496f"

  - `candidates` (array, required)
    List of Golden Records Candidates.

  - `candidates.businessPartner` (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. Additional documentation can be found [here](https://meta.cdq.com/Business_partner).

  - `candidates.businessPartner.names` (array)
    List of Names.

  - `candidates.businessPartner.names.type` (object)
    Type of the name, e.g. a locally used name or an international version.

  - `candidates.businessPartner.names.type.url` (string)
    URL to the documentation which summarizes all details of the [Name Type](https://meta.cdq.com/Business_partner/name/type).
    Example: "https://meta.cdq.com/Business_partner/name/type"

  - `candidates.businessPartner.names.type.name` (string)
    Display label for the Name Type.
    Example: "Local Name"

  - `candidates.businessPartner.names.type.technicalKey` (string)
    Technical Keys of the Name Type.
    Example: "LOCAL"

  - `candidates.businessPartner.names.value` (string)
    The actual name.
    Example: "Corporate Data Quality AG"

  - `candidates.businessPartner.names.shortName` (string)
    The abbreviated variant of a company's full name.
    Example: "CDQ AG"

  - `candidates.businessPartner.names.language` (object)
    Name of a language according to ISO 639-1.

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

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

  - `candidates.businessPartner.names.details` (array)

  - `candidates.businessPartner.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"

  - `candidates.businessPartner.names.details.type` (object)
    Type of additional information to a [Business Partner Name](https://meta.cdq.com/Business_partner/name).

  - `candidates.businessPartner.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"

  - `candidates.businessPartner.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"

  - `candidates.businessPartner.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"

  - `candidates.businessPartner.legalForm` (object)
    The legal form of a [Business Partner/type/legal entity](https://meta.cdq.com/Business_partner/type/legal_entity) is the form it takes in the eyes of the law governing it. The legal form of a [company](https://meta.cdq.com/Business_partner) is the general type it may legally use to identify itself according to the local, regional, national, or international law governing it. This is normally reflected in the ending abbreviation after the [company](https://meta.cdq.com/Business_partner)'s name (e.g. AG, Inc., LLC, S.A.).

  - `candidates.businessPartner.legalForm.name` (string)
    Display of the Legal Form.
    Example: "Aktiengesellschaft"

  - `candidates.businessPartner.legalForm.url` (string)
    URL to the documentation which summarizes all details of [Legal Form](https://meta.cdq.com/Business_partner/legal_form).
    Example: "https://meta.cdq.com/Business_partner/legal_form"

  - `candidates.businessPartner.legalForm.technicalKey` (string)
    Technical Key of a Legal Form. Descriptions of below enums contain ,  and .
    Example: "DE_9866"

  - `candidates.businessPartner.legalForm.language` (object)
    Naming of a language according to ISO 639-1.

  - `candidates.businessPartner.legalForm.mainAbbreviation` (string)
    The primary abbreviation of a legal form, i.e. the most commonly used abbreviation in a country.
    Example: "AG"

  - `candidates.businessPartner.legalForm.categories` (array)
    List of Legal Form categories.

  - `candidates.businessPartner.legalForm.categories.name` (string)
    Descriptive display name of the Legal Form Category.
    Example: "Limited Liability Company"

  - `candidates.businessPartner.legalForm.categories.url` (string)
    URL to the documentation which summarizes all details of the [Legal Form Category](https://meta.cdq.com/Business_partner/legal_form/category).
    Example: "https://meta.cdq.com/Business_partner/legal_form/category/technical_key/LF001"

  - `candidates.businessPartner.legalForm.categories.shortName` (string)
    Short display name of the Legal Form Category.
    Example: "LLC"

  - `candidates.businessPartner.legalForm.categories.technicalKey` (string)
    Technical Key of the [Legal Form Category](https://meta.cdq.com/Business_partner/legal_form/category).
    Example: "LIMITED"

  - `candidates.businessPartner.legalForm.cdlElfCode` (string)
    An unique identifier for CDL managed Legal Forms.
    Example: "AG"

  - `candidates.businessPartner.identifiers` (array)
    List of Identifiers.

  - `candidates.businessPartner.identifiers.type` (object)
    Type of the identifier. Allowed types are documented [here](https://meta.cdq.com/Category:Business_partner/identifier/type).

  - `candidates.businessPartner.identifiers.type.url` (string)
    URL to the documentation which summarizes all details of an [Identifier](https://meta.cdq.com/Business_partner/identifier/type).
    Example: "https://meta.cdq.com/Business_partner/identifier/type"

  - `candidates.businessPartner.identifiers.type.name` (string)
    Display label for the Identifier.
    Example: "CH_VAT_ID"

  - `candidates.businessPartner.identifiers.type.technicalKey` (string)
    Technical key of the type of the Identifier.
    Example: "CH_VAT_ID"

  - `candidates.businessPartner.identifiers.value` (string)
    Value of the identifier.
    Example: "CHE-218.608.886 HR/MWST"

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

  - `candidates.businessPartner.identifiers.issuingBody.name` (string)
    Preferred display label for an Issuing Body.
    Example: "Amtsgericht Aachen"

  - `candidates.businessPartner.identifiers.issuingBody.url` (string)
    URL to the documentation which summarizes all details of a [Issuing Body](https://meta.cdq.com/Business_partner/identifier/issuing_body).
    Example: "https://meta.cdq.com/Business_partner/identifier/issuing_body"

  - `candidates.businessPartner.identifiers.issuingBody.technicalKey` (string)
    Technical key of the Issuing Body.
    Example: "Amtsgericht Aachen"

  - `candidates.businessPartner.identifiers.issuingBody.jurisdiction` (object)
    The authority of an official organization to make decisions and judgments in a particular administrative area.

  - `candidates.businessPartner.identifiers.issuingBody.jurisdiction.country` (object)
    Country consisting of the country name and country code (ISO 3166-1 alpha-2).

  - `candidates.businessPartner.identifiers.issuingBody.jurisdiction.country.shortName` (string)
    Country code (ISO 3166-1 alpha-2).
    Example: "CH"

  - `candidates.businessPartner.identifiers.issuingBody.jurisdiction.country.value` (string)
    Country name (ISO 3166-1 alpha-2).
    Example: "Switzerland"

  - `candidates.businessPartner.identifiers.issuingBody.jurisdiction.administrativeAreas` (array)
    List of Administrative Areas.

  - `candidates.businessPartner.identifiers.issuingBody.jurisdiction.administrativeAreas.value` (string)
    Name of the [Administrative Area](https://meta.cdq.com/Address/administrative_area).
    Example: "Sankt Gallen"

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

  - `candidates.businessPartner.identifiers.issuingBody.jurisdiction.administrativeAreas.shortName` (string)
    Abbreviation for the [Administrative Area](https://meta.cdq.com/Address/administrative_area).
    Example: "SG"

  - `candidates.businessPartner.identifiers.issuingBody.jurisdiction.administrativeAreas.type` (object)
    Type of the [Administrative Area](https://meta.cdq.com/Address/administrative_area).

  - `candidates.businessPartner.identifiers.issuingBody.jurisdiction.administrativeAreas.type.name` (string)
    Display label for the Administrative Area Type.
    Example: "COUNTY"

  - `candidates.businessPartner.identifiers.issuingBody.jurisdiction.administrativeAreas.type.url` (string)
    URL to the documentation which summarizes all details of the [Administrative Area](https://meta.cdq.com/Address/administrative_area/type).
    Example: "https://meta.cdq.com/Address/administrative_area/type"

  - `candidates.businessPartner.identifiers.issuingBody.jurisdiction.administrativeAreas.type.technicalKey` (string)
    Technical key of the Administrative Area.
    Example: "COUNTY"

  - `candidates.businessPartner.identifiers.status` (object)
    Identifier Status refers to the current state of a unique identification number.

  - `candidates.businessPartner.identifiers.status.name` (string)
    Display label for the Identifier Status Name.
    Example: "ACTIVE"

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

  - `candidates.businessPartner.categories` (array)
    List of Categories.

  - `candidates.businessPartner.categories.name` (string)
    Display name of the Business Partner Category Name.
    Example: "Hotel"

  - `candidates.businessPartner.categories.url` (string)
    URL to the documentation which summarizes all details of the [Business Partner Category](https://meta.cdq.com/Business_partner/category).
    Example: "https://meta.cdq.com/Business_partner/category"

  - `candidates.businessPartner.categories.technicalKey` (string)
    Technical Key of the Business Partner Category.
    Example: "HOTEL"

  - `candidates.businessPartner.categories.score` (string)
    Score of business partner category
    Example: "0.95"

  - `candidates.businessPartner.status` (object)
    Describes the status of a Business Partner with respect to its level of activity (e.g. out of business) or legally relevant conditions (e.g. in liquidation). Additional documentation can be found [here](https://meta.cdq.com/Business_partner/status).

  - `candidates.businessPartner.status.type` (object)
    The standardized status which the Business Partner currently has. Allowed types are documented [here](https://meta.cdq.com/Business_partner/status/type).

  - `candidates.businessPartner.status.type.name` (string)
    Display name of the Business Partner Status.
    Example: "In Liquidation"

  - `candidates.businessPartner.status.type.url` (string)
    URL to the documentation which summarizes all details of the [Business Partner Status](https://meta.cdq.com/Business_partner/status/type).
    Example: "https://meta.cdq.com/Business_partner/status/type"

  - `candidates.businessPartner.status.type.technicalKey` (string)
    Technical Key of the Business Parter Status.
    Example: "IN_LIQUIDATION"

  - `candidates.businessPartner.status.officialDenotation` (string)
    The status as provided by an official register.
    Example: "Good Standing"

  - `candidates.businessPartner.status.validFrom` (string)
    Describes since when a business partner turned or will turn into the provided status. If no official date is known, the date of changing the status in the CDQ Community Data Pool or an external data source is provided.
    Example: "2025-09-12T14:57:38Z"

  - `candidates.businessPartner.status.validUntil` (string)
    Describes until when a business partner had a certain status. If no official date is known, the date of changing the status in the CDQ Community Data Pool or an external data source is provided.
    Example: "2025-09-12T14:57:38Z"

  - `candidates.businessPartner.addresses` (array)
    List of Addresses.

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

  - `candidates.businessPartner.addresses.version.characterSet` (object)
    Available values can be found [here](https://meta.cdq.com/Address/version/character_set).

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

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

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

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

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

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

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

  - `candidates.businessPartner.addresses.contexts` (array)
    List of Address Contexts.

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

  - `candidates.businessPartner.addresses.postCodes` (array)
    List of additional Post Codes.

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

  - `candidates.businessPartner.addresses.postCodes.type` (object)
    Type of the Post Code. Allowed types are documented [here](https://meta.cdq.com/Address/post_code/type).

  - `candidates.businessPartner.addresses.postCodes.type.name` (string)
    Display label for the Post Code Type.
    Example: "Regular"

  - `candidates.businessPartner.addresses.postCodes.type.url` (string)
    URL to the documentation which summarizes all details of the [Administrative Area](https://meta.cdq.com/Address/post_code/type).
    Example: "https://meta.cdq.com/Address/post_code/type"

  - `candidates.businessPartner.addresses.postCodes.type.technicalKey` (string)
    Technical key of the Post Code.
    Example: "REGULAR"

  - `candidates.businessPartner.addresses.localities` (array)
    List of Localities.

  - `candidates.businessPartner.addresses.localities.type` (object)
    Type of the [Locality](https://meta.cdq.com/Address/locality). Allowed types are documented [here](https://meta.cdq.com/Address/locality/type).

  - `candidates.businessPartner.addresses.localities.type.name` (string)
    Display label for the Locality Type.
    Example: "City"

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

  - `candidates.businessPartner.addresses.localities.type.technicalKey` (string)
    Technical Key of the Locality Type.
    Example: "CITY"

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

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

  - `candidates.businessPartner.addresses.thoroughfares` (array)
    List of Thoroughfares.

  - `candidates.businessPartner.addresses.thoroughfares.type` (object)
    Type of the Thoroughfare. Allowed types are documented [here](https://meta.cdq.com/Address/thoroughfare/type).

  - `candidates.businessPartner.addresses.thoroughfares.type.name` (string)
    Display label for the Thoroughfare Type Name.
    Example: "Industrial zone"

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

  - `candidates.businessPartner.addresses.thoroughfares.type.technicalKey` (string)
    Technical key of the Thoroughfare Type.
    Example: "INDUSTRIAL_ZONE"

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

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

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

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

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

  - `candidates.businessPartner.addresses.premises` (array)
    List of Premises.

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

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

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

  - `candidates.businessPartner.addresses.premises.type` (object)
    Type of the Premise. Allowed types are documented [here](https://meta.cdq.com/Address/premise/type).

  - `candidates.businessPartner.addresses.premises.type.name` (string)
    Display label for the Premise Type.
    Example: "Factory"

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

  - `candidates.businessPartner.addresses.premises.type.technicalKey` (string)
    Technical key of the Premise Type.
    Example: "FACTORY"

  - `candidates.businessPartner.addresses.postalDeliveryPoints` (array)
    List of Postal Delivery Points.

  - `candidates.businessPartner.addresses.postalDeliveryPoints.type` (object)
    A single mailbox or other place at which postal mail is delivered. Allowed types are documented [here](https://meta.cdq.com/Address/postal_delivery_point/type).

  - `candidates.businessPartner.addresses.postalDeliveryPoints.type.name` (string)
    Display label for the Postal Delivery Point Type.
    Example: "Mailbox"

  - `candidates.businessPartner.addresses.postalDeliveryPoints.type.url` (string)
    URL to the documentation which summarizes all details of the [Postal Delivery Point](https://meta.cdq.com/Address/postal_delivery_point/type)
    Example: "https://meta.cdq.com/Address/postal_delivery_point/type"

  - `candidates.businessPartner.addresses.postalDeliveryPoints.type.technicalKey` (string)
    Technical key of the Postal Delivery Point.
    Example: "MAILBOX"

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

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

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

  - `candidates.businessPartner.addresses.geographicCoordinates` (object)
    Decimal geographic coordinates (WGS 84 - reference coordinate system). Additional documentation can be found [here](https://meta.cdq.com/Address/geographic_coordinates).

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

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

  - `candidates.businessPartner.addresses.types` (array)
    List of Address Types.

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

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

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

  - `candidates.businessPartner.externalId` (string)
    Arbitrary identifier type to mark customer IDs that are "external" from CDQ's perspective. This is the identifier a customer provides to identify its records.
    Example: "The ID managed in the customer's SAP systems."

  - `candidates.businessPartner.profile` (object)
    A Business Partner profile contains important information about a company, such as its classification, tags, contact details, or minority indicator. Additional documentation can be found [here](https://meta.cdq.com/Partner_profile).

  - `candidates.businessPartner.profile.classifications` (array)
    List of Classifications.

  - `candidates.businessPartner.profile.classifications.value` (string)
    A textual description of the Classification.
    Example: "Manufacture of pesticides and other agrochemical products."

  - `candidates.businessPartner.profile.classifications.code` (string)
    Code that classifies the business partner.
    Example: "20.20Z"

  - `candidates.businessPartner.profile.classifications.type` (object)
    Type of classification such as NACE, SIC, NAF or other industry classification standards.

  - `candidates.businessPartner.profile.classifications.type.name` (string)
    Display label for the Classification Type.
    Example: "NAF 2003"

  - `candidates.businessPartner.profile.classifications.type.url` (string)
    URL to the documentation which summarizes all details of the [Classification Type](https://meta.cdq.com/Business_partner/partner_profile/classification/type)
    Example: "https://meta.cdq.com/Business_partner/partner_profile/classification/type"

  - `candidates.businessPartner.profile.phoneNumbers` (array)
    List of Phone Numbers.

  - `candidates.businessPartner.profile.phoneNumbers.countryPrefix` (string)
    The country prefix of a phone number.
    Example: "+41"

  - `candidates.businessPartner.profile.phoneNumbers.number` (string)
    The complete phone number without any country prefixes.
    Example: "71 571 10 40"

  - `candidates.businessPartner.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).

  - `candidates.businessPartner.profile.phoneNumbers.type.name` (string)
    Display label for a Phone Number Type Name.
    Example: "FAX"

  - `candidates.businessPartner.profile.phoneNumbers.type.url` (string)
    URL to the documentation which summarizes all details of the [Phone Number Type](https://meta.cdq.com/Business_partner/partner_profile/phone_number/type).
    Example: "https://meta.cdq.com/Business_partner/partner_profile/phone_number/type"

  - `candidates.businessPartner.profile.phoneNumbers.value` (string)
    The actual complete phone number incl. country prefix.
    Example: "+41 71 571 10 40"

  - `candidates.businessPartner.profile.websites` (array)
    List of Websites.

  - `candidates.businessPartner.profile.websites.url` (string)
    The actual company website URL.
    Example: "https://cdq.com"

  - `candidates.businessPartner.profile.websites.type` (object)
    Describes the type of website of a Business Partner, e.g. corporate website, official LinkedIn profile, etc.

  - `candidates.businessPartner.profile.websites.type.name` (string)
    Display label for a Website Type Name
    Example: "Corporate Website"

  - `candidates.businessPartner.profile.websites.type.url` (string)
    URL to the documentation which summarizes [Website Type Name](https://meta.cdq.com/Business_Partner/partner_profile/website/type).
    Example: "https://meta.cdq.com/Business_Partner/partner_profile/website/type"

  - `candidates.businessPartner.profile.websites.type.technicalKey` (string)
    Technical Keys of the Website Type Name.
    Example: "WEBSITE_TYPE_CORPORATE"

  - `candidates.businessPartner.profile.contactEmails` (array)
    List of Contact Emails.

  - `candidates.businessPartner.profile.contactEmails.value` (string)
    Value of the email address of the Business Partner.
    Example: "developer-portal@cdq.com"

  - `candidates.businessPartner.types` (array)
    List of Business Partner Types.

  - `candidates.businessPartner.types.name` (string)
    Display name of the Business Partner Type Name.
    Example: "Legal Entity"

  - `candidates.businessPartner.types.url` (string)
    URL to the documentation which summarizes all details of a [Buisness Partner Type](https://meta.cdq.com/Business_partner/type).
    Example: "https://meta.cdq.com/Business_partner/type"

  - `candidates.businessPartner.types.technicalKey` (string)
    Technical key of the Business Partner Type.
    Example: "LEGAL_ENTITY"

  - `candidates.matchingProfile` (object)
    Matching profile used for the match. It contains the matching threshold and the matching scores.

  - `candidates.matchingProfile.matchingScores` (object)
    List of the numerical value of similarity between Business Partners or addresses enhanced with the overall score.

  - `candidates.matchingProfile.matchingScores.overall` (object)
    Shows numerical value of similarity between Business Partners or address stored in the Data Mirror and the Business Partner from the request.

  - `candidates.matchingProfile.matchingScores.overall.classification` (object)
    Classification of the matching score. It can be ,  or .

  - `candidates.matchingProfile.matchingScores.overall.classification.technicalKey` (string)
    Technical key of the Matching Classification.
    Example: "HIGH"

  - `candidates.matchingProfile.matchingScores.overall.classification.name` (string)
    Name of the Matching Classification.
    Example: "My Matching Configuration"

  - `candidates.matchingProfile.matchingScores.overall.value` (number)
    Matching score value.
    Example: "0.9"

  - `candidates.matchingProfile.matchingScores.overall.explanation` (string)
    Explanation for matching score value.
    Example: "BP: [overall: [IDENTIFIER: 0.55; overall: 0.55;]] A: [overall: [COUNTRY_SHORTNAME: 0.5; overall: 0.5;]]"

  - `candidates.matchingProfile.matchingScores.businessPartner` (object)
    Shows numerical value of similarity between Business Partners or address stored in the Data Mirror and the Business Partner from the request.

  - `candidates.matchingProfile.matchingScores.address` (object)
    Shows numerical value of similarity between Business Partners or address stored in the Data Mirror and the Business Partner from the request.

  - `candidates.dataSource` (object)
    Represents external Data Source.

  - `candidates.dataSource.name` (string)
    Display Name of the Provenance Name.
    Example: "VIES"

  - `candidates.dataSource.technicalKey` (string)
    Technical Key of the Provenance Name.
    Example: "VIES"

  - `candidates.cdqId` (string)
    CDQ ID of the Golden Record.
    Example: "VIES:PL1132639219"

## Response 200 fields (application/json):

  - `businessPartner` (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. Additional documentation can be found [here](https://meta.cdq.com/Business_partner).

  - `businessPartner.names` (array)
    List of Names.

  - `businessPartner.names.type` (object)
    Type of the name, e.g. a locally used name or an international version.

  - `businessPartner.names.type.url` (string)
    URL to the documentation which summarizes all details of the [Name Type](https://meta.cdq.com/Business_partner/name/type).
    Example: "https://meta.cdq.com/Business_partner/name/type"

  - `businessPartner.names.type.name` (string)
    Display label for the Name Type.
    Example: "Local Name"

  - `businessPartner.names.type.technicalKey` (string)
    Technical Keys of the Name Type.
    Example: "LOCAL"

  - `businessPartner.names.value` (string)
    The actual name.
    Example: "Corporate Data Quality AG"

  - `businessPartner.names.shortName` (string)
    The abbreviated variant of a company's full name.
    Example: "CDQ AG"

  - `businessPartner.names.language` (object)
    Name of a language according to ISO 639-1.

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

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

  - `businessPartner.names.details` (array)

  - `businessPartner.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"

  - `businessPartner.names.details.type` (object)
    Type of additional information to a [Business Partner Name](https://meta.cdq.com/Business_partner/name).

  - `businessPartner.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"

  - `businessPartner.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"

  - `businessPartner.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"

  - `businessPartner.legalForm` (object)
    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.).

  - `businessPartner.legalForm.name` (string)
    Display of the Legal Form.
    Example: "Aktiengesellschaft"

  - `businessPartner.legalForm.url` (string)
    URL to the documentation which summarizes all details of [Legal Form](https://meta.cdq.com/Business_partner/legal_form).
    Example: "https://meta.cdq.com/Business_partner/legal_form"

  - `businessPartner.legalForm.technicalKey` (string)
    Technical Key of a Legal Form. Descriptions of below enums contain ,  and .
    Example: "DE_9866"

  - `businessPartner.legalForm.language` (object)
    Naming of a language according to ISO 639-1.

  - `businessPartner.legalForm.mainAbbreviation` (string)
    The primary abbreviation of a legal form, i.e. the most commonly used abbreviation in a country.
    Example: "AG"

  - `businessPartner.legalForm.categories` (array)
    List of Categories of the Legal Form.

  - `businessPartner.legalForm.categories.name` (string)
    Descriptive display name of the Legal Form Category.
    Example: "Limited Liability Company"

  - `businessPartner.legalForm.categories.url` (string)
    URL to the documentation which summarizes all details of the [Legal Form Category](https://meta.cdq.com/Business_partner/legal_form/category).
    Example: "https://meta.cdq.com/Business_partner/legal_form/category/technical_key/LF001"

  - `businessPartner.legalForm.categories.shortName` (string)
    Short display name of the Legal Form Category.
    Example: "LLC"

  - `businessPartner.legalForm.categories.technicalKey` (string)
    Technical Key of the [Legal Form Category](https://meta.cdq.com/Business_partner/legal_form/category).
    Example: "LIMITED"

  - `businessPartner.legalForm.cdlElfCode` (string)
    An unique identifier for CDL managed Legal Forms.
    Example: "AG"

  - `businessPartner.identifiers` (array)
    List of Identifiers.

  - `businessPartner.identifiers.type` (object)
    Type of the identifier. Allowed types are documented [here](https://meta.cdq.com/Category:Business_partner/identifier/type).

  - `businessPartner.identifiers.type.url` (string)
    URL to the documentation which summarizes all details of an [Identifier](https://meta.cdq.com/Business_partner/identifier/type).
    Example: "https://meta.cdq.com/Business_partner/identifier/type"

  - `businessPartner.identifiers.type.name` (string)
    Display label for the Identifier.
    Example: "CH_VAT_ID"

  - `businessPartner.identifiers.type.technicalKey` (string)
    Technical key of the type of the Identifier.
    Example: "CH_VAT_ID"

  - `businessPartner.identifiers.value` (string)
    Value of the identifier.
    Example: "CHE-218.608.886 HR/MWST"

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

  - `businessPartner.identifiers.issuingBody.name` (string)
    Preferred display label for an Issuing Body.
    Example: "Amtsgericht Aachen"

  - `businessPartner.identifiers.issuingBody.url` (string)
    URL to the documentation which summarizes all details of a [Issuing Body](https://meta.cdq.com/Business_partner/identifier/issuing_body).
    Example: "https://meta.cdq.com/Business_partner/identifier/issuing_body"

  - `businessPartner.identifiers.issuingBody.technicalKey` (string)
    Technical key of the Issuing Body.
    Example: "Amtsgericht Aachen"

  - `businessPartner.identifiers.issuingBody.jurisdiction` (object)
    The authority of an official organization to make decisions and judgments in a particular administrative area.

  - `businessPartner.identifiers.issuingBody.jurisdiction.country` (object)
    Country consisting of the country name and country code (ISO 3166-1 alpha-2).

  - `businessPartner.identifiers.issuingBody.jurisdiction.country.shortName` (string)
    Country code (ISO 3166-1 alpha-2).
    Example: "CH"

  - `businessPartner.identifiers.issuingBody.jurisdiction.country.value` (string)
    Country name (ISO 3166-1 alpha-2).
    Example: "Switzerland"

  - `businessPartner.identifiers.issuingBody.jurisdiction.administrativeAreas` (array)
    List of Administrative Areas.

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

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

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

  - `businessPartner.identifiers.issuingBody.jurisdiction.administrativeAreas.type` (object)
    Type of the [Administrative Area](https://meta.cdq.com/Address/administrative_area).

  - `businessPartner.identifiers.issuingBody.jurisdiction.administrativeAreas.type.name` (string)
    Display label for the Administrative Area Type.
    Example: "COUNTY"

  - `businessPartner.identifiers.issuingBody.jurisdiction.administrativeAreas.type.url` (string)
    URL to the documentation which summarizes all details of the [Administrative Area](https://meta.cdq.com/Address/administrative_area/type).
    Example: "https://meta.cdq.com/Address/administrative_area/type"

  - `businessPartner.identifiers.issuingBody.jurisdiction.administrativeAreas.type.technicalKey` (string)
    Technical key of the Administrative Area.
    Example: "COUNTY"

  - `businessPartner.identifiers.status` (object)
    Identifier Status refers to the current state of a unique identification number.

  - `businessPartner.identifiers.status.name` (string)
    Display label for the Identifier Status Name.
    Example: "ACTIVE"

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

  - `businessPartner.categories` (array)
    List of Categories.

  - `businessPartner.categories.name` (string)
    Display name of the Business Partner Category Name.
    Example: "Hotel"

  - `businessPartner.categories.url` (string)
    URL to the documentation which summarizes all details of the [Business Partner Category](https://meta.cdq.com/Business_partner/category).
    Example: "https://meta.cdq.com/Business_partner/category"

  - `businessPartner.categories.technicalKey` (string)
    Technical Key of the Business Partner Category.
    Example: "HOTEL"

  - `businessPartner.categories.score` (string)
    Score of business partner category
    Example: "0.95"

  - `businessPartner.status` (object)
    Describes the status of a Business Partner with respect to its level of activity (e.g. out of business) or legally relevant conditions (e.g. in liquidation). Additional documentation can be found [here](https://meta.cdq.com/Business_partner/status).

  - `businessPartner.status.type` (object)
    The standardized status which the Business Partner currently has. Allowed types are documented [here](https://meta.cdq.com/Business_partner/status/type).

  - `businessPartner.status.type.name` (string)
    Display name of the Business Partner Status.
    Example: "In Liquidation"

  - `businessPartner.status.type.url` (string)
    URL to the documentation which summarizes all details of the [Business Partner Status](https://meta.cdq.com/Business_partner/status/type).
    Example: "https://meta.cdq.com/Business_partner/status/type"

  - `businessPartner.status.type.technicalKey` (string)
    Technical Key of the Business Parter Status.
    Example: "IN_LIQUIDATION"

  - `businessPartner.status.officialDenotation` (string)
    The status as provided by an official register.
    Example: "Good Standing"

  - `businessPartner.status.validFrom` (string)
    Describes since when a business partner turned or will turn into the provided status. If no official date is known, the date of changing the status in the CDQ Community Data Pool or an external data source is provided.
    Example: "2025-09-12T14:57:38Z"

  - `businessPartner.status.validUntil` (string)
    Describes until when a business partner had a certain status. If no official date is known, the date of changing the status in the CDQ Community Data Pool or an external data source is provided.
    Example: "2025-09-12T14:57:38Z"

  - `businessPartner.addresses` (array)
    List of Addresses.

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

  - `businessPartner.addresses.version.characterSet` (object)
    Available values can be found [here](https://meta.cdq.com/Address/version/character_set).

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

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

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

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

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

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

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

  - `businessPartner.addresses.contexts` (array)
    List of Address Contexts.

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

  - `businessPartner.addresses.postCodes` (array)
    List of additional Post Codes.

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

  - `businessPartner.addresses.postCodes.type` (object)
    Type of the Post Code. Allowed types are documented [here](https://meta.cdq.com/Address/post_code/type).

  - `businessPartner.addresses.postCodes.type.name` (string)
    Display label for the Post Code Type.
    Example: "Regular"

  - `businessPartner.addresses.postCodes.type.url` (string)
    URL to the documentation which summarizes all details of the [Administrative Area](https://meta.cdq.com/Address/post_code/type).
    Example: "https://meta.cdq.com/Address/post_code/type"

  - `businessPartner.addresses.postCodes.type.technicalKey` (string)
    Technical key of the Post Code.
    Example: "REGULAR"

  - `businessPartner.addresses.localities` (array)
    List of Localities.

  - `businessPartner.addresses.localities.type` (object)
    Type of the [Locality](https://meta.cdq.com/Address/locality). Allowed types are documented [here](https://meta.cdq.com/Address/locality/type).

  - `businessPartner.addresses.localities.type.name` (string)
    Display label for the Locality Type.
    Example: "City"

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

  - `businessPartner.addresses.localities.type.technicalKey` (string)
    Technical Key of the Locality Type.
    Example: "CITY"

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

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

  - `businessPartner.addresses.thoroughfares` (array)
    List of Thoroughfares.

  - `businessPartner.addresses.thoroughfares.type` (object)
    Type of the Thoroughfare. Allowed types are documented [here](https://meta.cdq.com/Address/thoroughfare/type).

  - `businessPartner.addresses.thoroughfares.type.name` (string)
    Display label for the Thoroughfare Type Name.
    Example: "Industrial zone"

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

  - `businessPartner.addresses.thoroughfares.type.technicalKey` (string)
    Technical key of the Thoroughfare Type.
    Example: "INDUSTRIAL_ZONE"

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

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

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

  - `businessPartner.addresses.thoroughfares.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"

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

  - `businessPartner.addresses.premises` (array)
    List of Premises.

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

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

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

  - `businessPartner.addresses.premises.type` (object)
    Type of the Premise. Allowed types are documented [here](https://meta.cdq.com/Address/premise/type).

  - `businessPartner.addresses.premises.type.name` (string)
    Display label for the Premise Type.
    Example: "Factory"

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

  - `businessPartner.addresses.premises.type.technicalKey` (string)
    Technical key of the Premise Type.
    Example: "FACTORY"

  - `businessPartner.addresses.postalDeliveryPoints` (array)
    List of Postal Delivery Points.

  - `businessPartner.addresses.postalDeliveryPoints.type` (object)
    A single mailbox or other place at which postal mail is delivered. Allowed types are documented [here](https://meta.cdq.com/Address/postal_delivery_point/type).

  - `businessPartner.addresses.postalDeliveryPoints.type.name` (string)
    Display label for the Postal Delivery Point Type.
    Example: "Mailbox"

  - `businessPartner.addresses.postalDeliveryPoints.type.url` (string)
    URL to the documentation which summarizes all details of the [Postal Delivery Point](https://meta.cdq.com/Address/postal_delivery_point/type)
    Example: "https://meta.cdq.com/Address/postal_delivery_point/type"

  - `businessPartner.addresses.postalDeliveryPoints.type.technicalKey` (string)
    Technical key of the Postal Delivery Point.
    Example: "MAILBOX"

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

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

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

  - `businessPartner.addresses.geographicCoordinates` (object)
    Decimal geographic coordinates (WGS 84 - reference coordinate system). Additional documentation can be found [here](https://meta.cdq.com/Address/geographic_coordinates).

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

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

  - `businessPartner.addresses.types` (array)
    List of Address Types.

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

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

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

  - `businessPartner.externalId` (string)
    Arbitrary identifier type to mark customer IDs that are "external" from CDQ's perspective. This is the identifier a customer provides to identify its records.
    Example: "The ID managed in the customer's SAP systems."

  - `businessPartner.profile` (object)
    A Business Partner profile contains important information about a company, such as its classification, tags, contact details, or minority indicator. Additional documentation can be found [here](https://meta.cdq.com/Partner_profile).

  - `businessPartner.profile.classifications` (array)
    List of Classifications.

  - `businessPartner.profile.classifications.value` (string)
    A textual description of the Classification.
    Example: "Manufacture of pesticides and other agrochemical products."

  - `businessPartner.profile.classifications.code` (string)
    Code that classifies the business partner.
    Example: "20.20Z"

  - `businessPartner.profile.classifications.type` (object)
    Type of classification such as NACE, SIC, NAF or other industry classification standards.

  - `businessPartner.profile.classifications.type.name` (string)
    Display label for the Classification Type.
    Example: "NAF 2003"

  - `businessPartner.profile.classifications.type.url` (string)
    URL to the documentation which summarizes all details of the [Classification Type](https://meta.cdq.com/Business_partner/partner_profile/classification/type)
    Example: "https://meta.cdq.com/Business_partner/partner_profile/classification/type"

  - `businessPartner.profile.phoneNumbers` (array)
    List of Phone Numbers.

  - `businessPartner.profile.phoneNumbers.countryPrefix` (string)
    The country prefix of a phone number.
    Example: "+41"

  - `businessPartner.profile.phoneNumbers.number` (string)
    The complete phone number without any country prefixes.
    Example: "71 571 10 40"

  - `businessPartner.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).

  - `businessPartner.profile.phoneNumbers.type.name` (string)
    Display label for a Phone Number Type Name.
    Example: "FAX"

  - `businessPartner.profile.phoneNumbers.type.url` (string)
    URL to the documentation which summarizes all details of the [Phone Number Type](https://meta.cdq.com/Business_partner/partner_profile/phone_number/type).
    Example: "https://meta.cdq.com/Business_partner/partner_profile/phone_number/type"

  - `businessPartner.profile.phoneNumbers.value` (string)
    The actual complete phone number incl. country prefix.
    Example: "+41 71 571 10 40"

  - `businessPartner.profile.websites` (array)
    List of Websites.

  - `businessPartner.profile.websites.url` (string)
    The actual company website URL.
    Example: "https://cdq.com"

  - `businessPartner.profile.websites.type` (object)
    Describes the type of website of a Business Partner, e.g. corporate website, official LinkedIn profile, etc.

  - `businessPartner.profile.websites.type.name` (string)
    Display label for a Website Type Name
    Example: "Corporate Website"

  - `businessPartner.profile.websites.type.url` (string)
    URL to the documentation which summarizes [Website Type Name](https://meta.cdq.com/Business_Partner/partner_profile/website/type).
    Example: "https://meta.cdq.com/Business_Partner/partner_profile/website/type"

  - `businessPartner.profile.websites.type.technicalKey` (string)
    Technical Keys of the Website Type Name.
    Example: "WEBSITE_TYPE_CORPORATE"

  - `businessPartner.profile.contactEmails` (array)
    List of Contact Emails.

  - `businessPartner.profile.contactEmails.value` (string)
    Value of the email address of the Business Partner.
    Example: "developer-portal@cdq.com"

  - `businessPartner.types` (array)
    List of Business Partner Types.

  - `businessPartner.types.name` (string)
    Display name of the Business Partner Type Name.
    Example: "Legal Entity"

  - `businessPartner.types.url` (string)
    URL to the documentation which summarizes all details of a [Buisness Partner Type](https://meta.cdq.com/Business_partner/type).
    Example: "https://meta.cdq.com/Business_partner/type"

  - `businessPartner.types.technicalKey` (string)
    Technical key of the Business Partner Type.
    Example: "LEGAL_ENTITY"

  - `metadata` (array)
    List of Metadata.

  - `metadata.modifiedAt` (string)
    Date of modification (ISO 8601-compliant).
    Example: "2025-09-12T14:57:38Z"

  - `metadata.modifiedBy` (string)
    User or Client UUID which modified the resource.
    Example: "76248934691294444"

  - `metadata.dataSource` (object)
    Represents external Data Source.

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

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

  - `metadata.cdqId` (string)
    CDQ ID of the Business Partner.
    Example: "VIES:PL1132639219"

  - `metadata.inactive` (boolean)
    Indicate if BP used for Golden Record has inactive status.
    Example: "true"

  - `businessPartnerChanges` (array)
    List of Property Changes.

  - `businessPartnerChanges.externalIds` (array)
    List of External IDs.

  - `businessPartnerChanges.externalIds.externalId` (string)
    Value of the ExternalId of the business partner.
    Example: "123"

  - `businessPartnerChanges.externalIds.dataSourceId` (string)
    Technical Key of the Provenance Name.
    Example: "VIES"

  - `businessPartnerChanges.externalIds.id` (string)
    Unique identifier of the external ID.
    Example: "123"

  - `businessPartnerChanges.externalIds.concept` (object)
    The Concept is a part of the CDQ data model. For example Address is a concept of the Business Partner and have many subconcepts as Locality, Thoroughfare, Administrative Area etc.

  - `businessPartnerChanges.externalIds.concept.name` (string)
    Display name of the Concept.
    Example: "Address"

  - `businessPartnerChanges.externalIds.concept.technicalKey` (string)
    Technical key of the Concept.
    Example: "ADDRESS"

  - `businessPartnerChanges.externalIds.characterSet` (object)
    Character set.

  - `businessPartnerChanges.externalIds.type` (object)
    An address type characterizes an address. The type of address is a structural statement and provides a truth that is applicable to any user (e.g. a legal address is a fact, or that an address is a PO BOX address), other than address functions that may differ from user to user. Address functions determine the particular business context in which an address is in use. Allowed types are documented [here](https://meta.cdq.com/Address/type).

  - `businessPartnerChanges.property` (object)
    Part of a concept. It describes a single attribute of a concept.

  - `businessPartnerChanges.property.parentConcept` (object)
    The Concept is a part of the CDQ data model. For example Address is a concept of the Business Partner and have many subconcepts as Locality, Thoroughfare, Administrative Area etc.

  - `businessPartnerChanges.property.name` (string)
    Name of the property.
    Example: "Minority Indicator Value"

  - `businessPartnerChanges.property.technicalKey` (string)
    Technical key of the property.
    Example: "MINORITY_INDICATOR_VALUE"

  - `businessPartnerChanges.property.contentSelector` (string)
    JSON path to the property in the provided JSON object.
    Example: "$.partnerProfile.minorityIndicator.value"

  - `businessPartnerChanges.property.instanceSelectors` (array)
    List of Instance Selectors.

  - `businessPartnerChanges.property.instanceSelectors.key` (string)
    JSON subpath to the property allowing to select concrete instance of a property in the provided JSON object.
    Example: "type.technicalKey"

  - `businessPartnerChanges.property.instanceSelectors.value` (string)
    Value of a JSON subpath to the property allowing to select concrete instance of a property in the provided JSON object.
    Example: "CH_UID"

  - `businessPartnerChanges.newContent` (string)
    New value after change
    Example: "AAB"

  - `businessPartnerChanges.previousContent` (string)
    Value before change
    Example: "AAB"

  - `businessPartnerChanges.provenance` (object)
    The source of the change or update. Could be the reference data source as VIES or Organization.

  - `businessPartnerChanges.provenance.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="

  - `businessPartnerChanges.provenance.cdqId` (string)
    The ID provided for a linkage with the source by CDQ.
    Example: "VIES:PL8660001429"

  - `businessPartnerChanges.provenance.subscribers` (integer)
    Number of Provenance Subscribers.
    Example: "7"

  - `businessPartnerChanges.provenance.subscribed` (boolean)
    Is Provenance Subscribed.
    Example: "true"

  - `businessPartnerChanges.provenance.lastUpdatedAt` (string)
    Provenance Last Updated Date.
    Example: "2025-09-12T14:57:38Z"

  - `businessPartnerChanges.provenance.lastSyncAt` (string)
    Provenance Last Sync Date.
    Example: "2025-09-12T14:57:38Z"

  - `businessPartnerChanges.changeType` (string)
    Type of the Property Change Type.
    Example: "MODIFIED"

  - `businessPartnerChanges.changeClassification` (string)
    Gives a user an indicator how "much" the attribute was changed OR how important the change was. Allowed values are:
 *  - Trivial change
 *  - Minor change
 *  - Major change
 *  - Critical change
    Example: "MAJOR"

  - `businessPartnerChanges.confidenceScore` (number)
    Confidence score which shows how confident CDQ is about enrichment of that property. Calculation dependes on property type, see here for a complete description.
    Example: "0.0"

  - `businessPartnerChanges.maxConfidenceScore` (number)
    Maximum confidence score which is achievable for this property type. Note that the max value will change over time depending on the udnerlying algorithm which will be continously improved.
    Example: "1.0"

  - `businessPartnerChanges.matchingScores` (object)
    Contains matching scores for the given property. The scores are calculated based on the input and the reference data. The scores are calculated for each instance of the property. The scores are calculated for each instance of the property. The scores are calculated for each instance of the property.

  - `businessPartnerChanges.matchingScores.overall` (number)
    Overall matching score value for Business Partner and Address.
    Example: "0.9"

  - `businessPartnerChanges.matchingScores.businessPartner` (number)
    Matching score value for Business Partner.
    Example: "0.9"

  - `businessPartnerChanges.matchingScores.address` (number)
    Matching score value for Address.
    Example: "0.9"

  - `goldenRecordUses` (array)
    Describes which entries were used to compose golden record and which one is the primary (base) entry

  - `goldenRecordUses.cdqId` (string)
    CDQ ID of the Golden Record.
    Example: "VIES:PL1132639219"

  - `goldenRecordUses.use` (string)
    Marks how was business partner used:
 *  - Base entry for golden record
 *  - Entry used to add information to base entry
    Example: "PRIMARY"