# Confirm Business Partner

BETAConfirms the validity of a trading partner by checking the provided data against various CDQ services.


Endpoint: POST /v2/businesspartners/confirm
Version: 2
Security: apiKey

## Query parameters:

  - `dataTransformationDefinitionId` (string)
    The ID of the data transformation definition to apply.
    Example: "123456"

## Request fields (application/json):

  - `businessPartner` (object)
    Refers to an organizational entity engaged in various facets of another organization's business interactions. 
This collaborative connection often manifests as a customer, supplier, vendor, or service provider. In the CDQ 
(Corporate Data Quality) framework, the Business Partner assumes a pivotal role as a core managed entity. Each 
Business Partner is distinctly and globally identifiable through a unique CDQ ID. All pertinent information, 
including addresses, identifiers, and hierarchical data, is intricately associated with and linked to the 
specific Business Partner, ensuring comprehensive management and traceability within the system.

  - `businessPartner.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.jsonRecord` (string)
    Object provided in plain JSON format.
    Example: "{ \"key\" : \"value\"}"

  - `businessPartner.names` (array)
    List of names of the Business Partner.

  - `businessPartner.names.type` (object)
    The 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.legalForm` (object)
    The legal form of a Business Partner is the form it takes in the eyes of the law governing it. The legal form 
of a company 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'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.cdlElfCode` (string)
    An unique identifier for CDL managed Legal Forms.
    Example: "AG"

  - `businessPartner.identifiers` (array)
    List of identifiers of the Business Partner.

  - `businessPartner.identifiers.type` (object)
    Type of the identifier.

  - `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)
    Represents the authority or organization that issued a compliance or sanction list.

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

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

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

  - `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 of the Business Partner.

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

  - `businessPartner.status.type` (object)
    The standardized status which the business partner currently has.

  - `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-08-27T14:26: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-08-27T14:26:38Z"

  - `businessPartner.profile` (object)
    A Business Partner profile contains important information about a company, such as its classification, tags, contact details, or minority indicator.

  - `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.classifications.type.technicalKey` (string)
    TechnicalKey for the Classification Type.
    Example: "NAF 2003"

  - `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.type.technicalKey` (string)
    Technical Keys of the PhoneNumber.
    Example: "FAX"

  - `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 types of the Business Partner.

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

  - `businessPartner.relations` (array)
    List of relations.

  - `businessPartner.relations.startedAt` (string)
    Describe when this relationship was first established.
    Example: "2025-08-27T14:26:38Z"

  - `businessPartner.relations.endedAt` (string)
    Describe when this relationship ended.
    Example: "2025-08-27T14:26:38Z"

  - `businessPartner.relations.type` (object)
    Provides information about the type of the relationship between two Business Partners like:\ direct parent/child, ultimate parent, branch.

  - `businessPartner.relations.type.name` (string)
    Display name of the Business Partner Relation Type.
    Example: "Commercial ultimate"

  - `businessPartner.relations.type.technicalKey` (string)
    Technical Key of the Business Partner Relation Type.
    Example: "COMMERCIAL_ULTIMATE"

  - `businessPartner.relations.class` (object)
    Provides information about the classification of the relation.

  - `businessPartner.relations.class.name` (string)
    Display name of the Business Partner Relation Class.
    Example: "CDQ Hierarchy"

  - `businessPartner.relations.class.technicalKey` (string)
    Technical Key of the Business Partner Relation Class.
    Example: "BUSINESS_PARTNER_RELATION_CLASS_CDQ_HIERARCHY"

  - `businessPartner.relations.startNode` (object)
    Unique identifiers for Business Partner in the relation

  - `businessPartner.relations.startNode.dataSourceId` (string)
    Unique identifier for a Data Source of the Storage.
    Example: "648824a691d8d2503d65103e"

  - `businessPartner.relations.endNode` (object)
    Unique identifiers for Business Partner in the relation

  - `businessPartner.relations.deactivatedAt` (string)
    Describe when this relationship was deactivated. Read only.
    Example: "2025-08-27T14:26:38Z"

  - `businessPartner.addresses` (array)
    List of addresses of the Business Partner.

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

  - `businessPartner.addresses.cdqId` (string)
    CDQ ID of an address.
    Example: "CDQID-123456789"

  - `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)
    Character set. 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.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 contexts of the address.

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

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

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

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

  - `businessPartner.addresses.administrativeAreas` (array)
    List of administrative areas of the address.

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

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

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

  - `businessPartner.addresses.administrativeAreas.type` (object)
    The type of the administrative area.

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

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

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

  - `businessPartner.addresses.postCodes` (array)
    List of post codes of the address.

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

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

  - `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 of the address.

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

  - `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 of the address.

  - `businessPartner.addresses.thoroughfares.type` (object)
    Type of the thoroughfare.

  - `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 of the address.

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

  - `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 of the address.

  - `businessPartner.addresses.postalDeliveryPoints.type` (object)
    A single mailbox or other place at which postal mail is delivered.

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

  - `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 types of the address.

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

  - `featuresOn` (array)
    List of features to be activated.
    Enum: "ENABLE_SANCTION_CONFIRMATION", "ENABLE_QUALIFICATION_CONFIRMATION"

  - `featuresOff` (array)
    List of features to be deactivated.
    Enum: "ENABLE_SANCTION_CONFIRMATION", "ENABLE_QUALIFICATION_CONFIRMATION"

## Response 200 fields (application/json):

  - `status` (object)
    Details about status or error of a service.

  - `status.code` (integer)
    RFC 7231 status code for this error.
    Example: "400"

  - `status.technicalKey` (string)
    Technical key describing the status or error
    Example: "OK"

  - `status.details` (array)
    List of details about the status or error.

  - `status.details.id` (integer, required)
    9-digit code which is uniquely identifying a message
    Example: 200000004

  - `status.details.message` (string, required)
    Human-readable message which may also be presented in user interface.
    Example: "Business Partner Name is mandatory."

  - `status.details.technicalKey` (string)
    Technical key to uniquely identify a message.
    Example: "JOB_FINISHED"

  - `status.details.jsonPath` (string)
    JSONPath as specified by the IETF standard
    Example: "$.businessPartner.names[0].value"

  - `status.details.jsonRecord` (string)
    Object provided in plain JSON format.
    Example: "{ \"key\" : \"value\"}"

  - `status.path` (string)
    Requested path which caused this error.
    Example: "/v2/businesspartners/lookup"

  - `status.timestamp` (string)
    ISO 8601 representation of the timestamp.
    Example: "2025-08-27T14:26:38Z"

  - `dataQualityConfirmation` (object)
    Describes the outcome of data quality checks, including an overall decision and detailed reports of any issues found.

  - `dataQualityConfirmation.decision` (object)
    Provides decision of checks against compliance lists.

  - `dataQualityConfirmation.decision.technicalKey` (string)
    Represents the possible outcomes of a data validation process, including successful validation, failure, or non-applicability.
    Example: "OK"

  - `dataQualityConfirmation.summary` (object)
    Summarizes the results of data quality checks including counts of errors, warnings, and informational messages.

  - `dataQualityConfirmation.summary.numErrors` (integer)
    Number of errors found during data quality checks.
    Example: "0"

  - `dataQualityConfirmation.summary.numWarnings` (integer)
    Number of warnings found during data quality checks.
    Example: "0"

  - `dataQualityConfirmation.summary.numInfos` (integer)
    Number of informational messages found during data quality checks.
    Example: "0"

  - `dataQualityConfirmation.details` (object)
    Provides detailed reports of data quality issues categorized into errors, warnings, and informational messages.

  - `dataQualityConfirmation.details.errors` (array)

  - `dataQualityConfirmation.details.errors.businessRule` (object)
    Details the specific business rule that has been violated, including its name and a link to its definition.

  - `dataQualityConfirmation.details.errors.businessRule.name` (string)
    Represents business rule name.
    Example: "Identifier unknown (European value added tax identifier (The Netherlands))"

  - `dataQualityConfirmation.details.errors.businessRule.url` (string)
    Represents Data Quality Rule url.
    Example: "https://meta.cdq.com/Identifier_unknown_(European_value_added_tax_identifier_(The_Netherlands))"

  - `dataQualityConfirmation.details.errors.businessRule.ruleStatus` (string)
    The status of a validation rule.
    Example: "RELEASED"

  - `dataQualityConfirmation.details.errors.violationLevel` (string)
    Indicates the criticality of the applied rule. 
If a data defect was found then user will get ,  or  level. Otherwise, it will be NO_DEFECT.
    Example: "INFO"

  - `dataQualityConfirmation.details.errors.violationMessage` (string)
    Descriptive message detailing the nature of the data defect.
    Example: "Business Partner identifier is mandatory."

  - `dataQualityConfirmation.details.warnings` (array)

  - `dataQualityConfirmation.details.infos` (array)

  - `companyConfirmation` (object)
    Contains results of the company confirmation process, verifying the existence and registration details of the company against trusted databases.

  - `companyConfirmation.summary` (object)
    Summarizes the company confirmation results, including the data source used for verification and the classification and score of the match.

  - `companyConfirmation.summary.dataSource` (object)
    Data Source of the Data Pool.

  - `companyConfirmation.summary.dataSource.name` (string)
    Name of the data source.
    Example: "Receita Federal Brazil"

  - `companyConfirmation.summary.dataSource.aleiPrefix` (string)
    The ALEI prefix element is the ISO 3166-2 code for country
and subdivision if applicable followed by the stop character ‘.’
This is followed by an acronym representing the register
maintained by the administrative agency for the governing
body of a nation, state, or community that assigned 
the identifier element. The prefix is assigned by ECCMA
    Example: "VIES"

  - `companyConfirmation.summary.dataSource.technicalKey` (string)
    Technical key of the data source.
    Example: "BR_RF"

  - `companyConfirmation.summary.overallMatchingClassification` (string)
    Enumerates the possible classifications for data matching, providing a clearer interpretation of the matching score.
    Example: "FULL_MATCH"

  - `companyConfirmation.summary.overallMatchingScore` (number)
    Numeric value representing the degree of match calculated during data validation processes.
    Example: "0.9"

  - `companyConfirmation.details` (object)
    Provides detailed results of the company verification process, including the matched company profile and related data.

  - `companyConfirmation.details.matchingProfile` (object)
    Contains a profile of matching scores that evaluate how well the trading partner data matches against various criteria.

  - `companyConfirmation.details.matchingProfile.matchingScores` (object)
    Provides detailed matching scores broken down into overall, business partner specific, and address specific evaluations.

  - `companyConfirmation.details.matchingProfile.matchingScores.overall` (object)
    Describes the matching score, including a classification, value, and explanation of the match.

  - `companyConfirmation.details.matchingProfile.matchingScores.overall.classification` (string)
    Enumerates the possible classifications for data matching, providing a clearer interpretation of the matching score.
    Example: "FULL_MATCH"

  - `companyConfirmation.details.matchingProfile.matchingScores.overall.value` (number)
    Numeric value representing the degree of match calculated during data validation processes.
    Example: "0.9"

  - `companyConfirmation.details.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;]]"

  - `companyConfirmation.details.matchingProfile.matchingScores.businessPartner` (object)
    Describes the matching score, including a classification, value, and explanation of the match.

  - `companyConfirmation.details.matchingProfile.matchingScores.address` (object)
    Describes the matching score, including a classification, value, and explanation of the match.

  - `companyConfirmation.details.matchedCompanyData` (object)
    Refers to an organizational entity engaged in various facets of another organization's business interactions. 
This collaborative connection often manifests as a customer, supplier, vendor, or service provider. In the CDQ 
(Corporate Data Quality) framework, the Business Partner assumes a pivotal role as a core managed entity. Each 
Business Partner is distinctly and globally identifiable through a unique CDQ ID. All pertinent information, 
including addresses, identifiers, and hierarchical data, is intricately associated with and linked to the 
specific Business Partner, ensuring comprehensive management and traceability within the system.

  - `companyConfirmation.details.matchedCompanyData.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."

  - `companyConfirmation.details.matchedCompanyData.names` (array)
    List of names of the Business Partner.

  - `companyConfirmation.details.matchedCompanyData.names.type` (object)
    The type of the name, e.g. a locally used name or an international version.

  - `companyConfirmation.details.matchedCompanyData.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"

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

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

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

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

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

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

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

  - `companyConfirmation.details.matchedCompanyData.legalForm` (object)
    The legal form of a Business Partner is the form it takes in the eyes of the law governing it. The legal form 
of a company 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's name (e.g. AG, Inc., LLC, S.A.).

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

  - `companyConfirmation.details.matchedCompanyData.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"

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

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

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

  - `companyConfirmation.details.matchedCompanyData.legalForm.categories` (array)
    List of categories of the legal form.

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

  - `companyConfirmation.details.matchedCompanyData.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"

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

  - `companyConfirmation.details.matchedCompanyData.identifiers` (array)
    List of identifiers of the Business Partner.

  - `companyConfirmation.details.matchedCompanyData.identifiers.type` (object)
    Type of the identifier.

  - `companyConfirmation.details.matchedCompanyData.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"

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

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

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

  - `companyConfirmation.details.matchedCompanyData.identifiers.issuingBody` (object)
    Represents the authority or organization that issued a compliance or sanction list.

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

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

  - `companyConfirmation.details.matchedCompanyData.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).

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

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

  - `companyConfirmation.details.matchedCompanyData.categories` (array)
    List of categories of the Business Partner.

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

  - `companyConfirmation.details.matchedCompanyData.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"

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

  - `companyConfirmation.details.matchedCompanyData.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).

  - `companyConfirmation.details.matchedCompanyData.status.type` (object)
    The standardized status which the business partner currently has.

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

  - `companyConfirmation.details.matchedCompanyData.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"

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

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

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

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

  - `companyConfirmation.details.matchedCompanyData.profile` (object)
    A Business Partner profile contains important information about a company, such as its classification, tags, contact details, or minority indicator.

  - `companyConfirmation.details.matchedCompanyData.profile.classifications` (array)
    List of classifications.

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

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

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

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

  - `companyConfirmation.details.matchedCompanyData.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"

  - `companyConfirmation.details.matchedCompanyData.profile.classifications.type.technicalKey` (string)
    TechnicalKey for the Classification Type.
    Example: "NAF 2003"

  - `companyConfirmation.details.matchedCompanyData.profile.phoneNumbers` (array)
    List of phone numbers.

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

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

  - `companyConfirmation.details.matchedCompanyData.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).

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

  - `companyConfirmation.details.matchedCompanyData.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"

  - `companyConfirmation.details.matchedCompanyData.profile.phoneNumbers.type.technicalKey` (string)
    Technical Keys of the PhoneNumber.
    Example: "FAX"

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

  - `companyConfirmation.details.matchedCompanyData.profile.websites` (array)
    List of websites.

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

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

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

  - `companyConfirmation.details.matchedCompanyData.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"

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

  - `companyConfirmation.details.matchedCompanyData.profile.contactEmails` (array)
    List of contact emails.

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

  - `companyConfirmation.details.matchedCompanyData.types` (array)
    List of types of the Business Partner.

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

  - `companyConfirmation.details.matchedCompanyData.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"

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

  - `companyConfirmation.details.matchedCompanyData.relations` (array)
    List of relations.

  - `companyConfirmation.details.matchedCompanyData.relations.startedAt` (string)
    Describe when this relationship was first established.
    Example: "2025-08-27T14:26:38Z"

  - `companyConfirmation.details.matchedCompanyData.relations.endedAt` (string)
    Describe when this relationship ended.
    Example: "2025-08-27T14:26:38Z"

  - `companyConfirmation.details.matchedCompanyData.relations.type` (object)
    Provides information about the type of the relationship between two Business Partners like:\ direct parent/child, ultimate parent, branch.

  - `companyConfirmation.details.matchedCompanyData.relations.type.name` (string)
    Display name of the Business Partner Relation Type.
    Example: "Commercial ultimate"

  - `companyConfirmation.details.matchedCompanyData.relations.type.technicalKey` (string)
    Technical Key of the Business Partner Relation Type.
    Example: "COMMERCIAL_ULTIMATE"

  - `companyConfirmation.details.matchedCompanyData.relations.class` (object)
    Provides information about the classification of the relation.

  - `companyConfirmation.details.matchedCompanyData.relations.class.name` (string)
    Display name of the Business Partner Relation Class.
    Example: "CDQ Hierarchy"

  - `companyConfirmation.details.matchedCompanyData.relations.class.technicalKey` (string)
    Technical Key of the Business Partner Relation Class.
    Example: "BUSINESS_PARTNER_RELATION_CLASS_CDQ_HIERARCHY"

  - `companyConfirmation.details.matchedCompanyData.relations.startNode` (object)
    Unique identifiers for Business Partner in the relation

  - `companyConfirmation.details.matchedCompanyData.relations.startNode.dataSourceId` (string)
    Unique identifier for a Data Source of the Storage.
    Example: "648824a691d8d2503d65103e"

  - `companyConfirmation.details.matchedCompanyData.relations.endNode` (object)
    Unique identifiers for Business Partner in the relation

  - `companyConfirmation.details.matchedCompanyData.relations.deactivatedAt` (string)
    Describe when this relationship was deactivated. Read only.
    Example: "2025-08-27T14:26:38Z"

  - `companyConfirmation.details.matchedCompanyData.addresses` (array)
    List of addresses of the Business Partner.

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

  - `companyConfirmation.details.matchedCompanyData.addresses.cdqId` (string)
    CDQ ID of an address.
    Example: "CDQID-123456789"

  - `companyConfirmation.details.matchedCompanyData.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.

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

  - `companyConfirmation.details.matchedCompanyData.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"

  - `companyConfirmation.details.matchedCompanyData.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"

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

  - `companyConfirmation.details.matchedCompanyData.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"

  - `companyConfirmation.details.matchedCompanyData.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.

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

  - `companyConfirmation.details.matchedCompanyData.addresses.contexts` (array)
    List of contexts of the address.

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

  - `companyConfirmation.details.matchedCompanyData.addresses.country` (object)
    Country consisting of the country name and country code (ISO 3166-1 alpha-2).

  - `companyConfirmation.details.matchedCompanyData.addresses.country.shortName` (string)
    Country code (ISO 3166-1 alpha-2).
    Example: "CH"

  - `companyConfirmation.details.matchedCompanyData.addresses.country.value` (string)
    Country name (ISO 3166-1 alpha-2).
    Example: "Switzerland"

  - `companyConfirmation.details.matchedCompanyData.addresses.administrativeAreas` (array)
    List of administrative areas of the address.

  - `companyConfirmation.details.matchedCompanyData.addresses.administrativeAreas.value` (string)
    Name of the [Administrative Area](https://meta.cdq.com/Address/administrative_area).
    Example: "Sankt Gallen"

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

  - `companyConfirmation.details.matchedCompanyData.addresses.administrativeAreas.shortName` (string)
    Abbreviation for the [Administrative Area](https://meta.cdq.com/Address/administrative_area).
    Example: "SG"

  - `companyConfirmation.details.matchedCompanyData.addresses.administrativeAreas.type` (object)
    The type of the administrative area.

  - `companyConfirmation.details.matchedCompanyData.addresses.administrativeAreas.type.name` (string)
    Display label for the Administrative Area Type.
    Example: "COUNTY"

  - `companyConfirmation.details.matchedCompanyData.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"

  - `companyConfirmation.details.matchedCompanyData.addresses.administrativeAreas.type.technicalKey` (string)
    Technical key of the Administrative Area.
    Example: "COUNTY"

  - `companyConfirmation.details.matchedCompanyData.addresses.postCodes` (array)
    List of post codes of the address.

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

  - `companyConfirmation.details.matchedCompanyData.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).

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

  - `companyConfirmation.details.matchedCompanyData.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"

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

  - `companyConfirmation.details.matchedCompanyData.addresses.localities` (array)
    List of localities of the address.

  - `companyConfirmation.details.matchedCompanyData.addresses.localities.type` (object)
    Type of the [Locality](https://meta.cdq.com/Address/locality).

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

  - `companyConfirmation.details.matchedCompanyData.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"

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

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

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

  - `companyConfirmation.details.matchedCompanyData.addresses.thoroughfares` (array)
    List of thoroughfares of the address.

  - `companyConfirmation.details.matchedCompanyData.addresses.thoroughfares.type` (object)
    Type of the thoroughfare.

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

  - `companyConfirmation.details.matchedCompanyData.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"

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

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

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

  - `companyConfirmation.details.matchedCompanyData.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"

  - `companyConfirmation.details.matchedCompanyData.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"

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

  - `companyConfirmation.details.matchedCompanyData.addresses.premises` (array)
    List of premises of the address.

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

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

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

  - `companyConfirmation.details.matchedCompanyData.addresses.premises.type` (object)
    Type of the Premise.

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

  - `companyConfirmation.details.matchedCompanyData.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"

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

  - `companyConfirmation.details.matchedCompanyData.addresses.postalDeliveryPoints` (array)
    List of postal delivery points of the address.

  - `companyConfirmation.details.matchedCompanyData.addresses.postalDeliveryPoints.type` (object)
    A single mailbox or other place at which postal mail is delivered.

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

  - `companyConfirmation.details.matchedCompanyData.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"

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

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

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

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

  - `companyConfirmation.details.matchedCompanyData.addresses.geographicCoordinates` (object)
    Decimal geographic coordinates (WGS 84 - reference coordinate system).

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

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

  - `companyConfirmation.details.matchedCompanyData.addresses.types` (array)
    List of types of the address.

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

  - `companyConfirmation.details.matchedCompanyData.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"

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

  - `qualificationConfirmation` (object)
    Outputs the results of identifier validation checks against official tax databases to ensure its validity.

  - `qualificationConfirmation.summary` (object)
    Summarizes the results of the VAT number confirmation including the data source used and details on various decision aspects.

  - `qualificationConfirmation.summary.decisionIdentifier` (string)
    Enumerates the potential outcomes of data qualification checks, useful for understanding validation results.
    Example: "VALID"

  - `qualificationConfirmation.summary.decisionName` (string)
    Enumerates the potential outcomes of data qualification checks, useful for understanding validation results.
    Example: "VALID"

  - `qualificationConfirmation.summary.decisionCity` (string)
    Enumerates the potential outcomes of data qualification checks, useful for understanding validation results.
    Example: "VALID"

  - `qualificationConfirmation.summary.decisionStreet` (string)
    Enumerates the potential outcomes of data qualification checks, useful for understanding validation results.
    Example: "VALID"

  - `qualificationConfirmation.summary.decisionPostalCode` (string)
    Enumerates the potential outcomes of data qualification checks, useful for understanding validation results.
    Example: "VALID"

  - `qualificationConfirmation.details` (object)
    Detailed results of the Qualification verification process including individual decision reports for each check performed.

  - `qualificationConfirmation.details.identifierResults` (object)
    Contains the results of a qualification check on a specific identifier, including the rule applied and the decision made.

  - `qualificationConfirmation.details.identifierResults.qualificationDecisions` (array)

  - `qualificationConfirmation.details.identifierResults.qualificationDecisions.qualificationTarget` (string)
    Specify the target attribute of the trading partner data that was subject to qualification.
    Example: "IDENTIFIER"

  - `qualificationConfirmation.details.identifierResults.qualificationDecisions.decision` (string)
    Enumerates the potential outcomes of data qualification checks, useful for understanding validation results.
    Example: "VALID"

  - `sanctionComplianceConfirmation` (object)
    Provides outcomes of checks against compliance lists like sanctions or watch lists to verify if the trading partner is compliant with regulatory standards.

  - `sanctionComplianceConfirmation.summary` (object)
    Summarizes the sanction screening results including the compliance list name and the matching score.

  - `sanctionComplianceConfirmation.summary.matchingScore` (object)
    Describes the matching score, including a classification, value, and explanation of the match.

  - `sanctionComplianceConfirmation.summary.complianceList` (object)
    Describes a compliance or sanction list used during the screening process, including its type, name, and issuing body.

  - `sanctionComplianceConfirmation.summary.complianceList.type` (string)
    Specifies the type of compliance list used during sanction screening processes.
    Example: "SANCTIONLIST"

  - `sanctionComplianceConfirmation.summary.complianceList.name` (string)
    The name of the compliance list.
    Example: "Seco List «Al-Qaïda»"

  - `sanctionComplianceConfirmation.summary.complianceList.technicalKey` (string)
    Technical key for the Compliance List.
    Example: "INFO4C_SL_1"

  - `sanctionComplianceConfirmation.summary.complianceList.rationale` (string)
    Explanation of the compliance list, e.g., country scope, political background, or legal basis.
    Example: "political background"

  - `sanctionComplianceConfirmation.details` (object)
    Details the specific matches found during the sanction screening process, including the list and score of each match.

  - `sanctionComplianceConfirmation.details.complianceListMatches` (array)

## Response 400 fields (application/json):

  - `status` (object)
    Details about status or error of a service.

  - `status.code` (integer)
    RFC 7231 status code for this error.
    Example: "400"

  - `status.technicalKey` (string)
    Technical key describing the status or error
    Example: "OK"

  - `status.details` (array)
    List of details about the status or error.

  - `status.details.id` (integer, required)
    9-digit code which is uniquely identifying a message
    Example: 200000004

  - `status.details.message` (string, required)
    Human-readable message which may also be presented in user interface.
    Example: "Business Partner Name is mandatory."

  - `status.details.technicalKey` (string)
    Technical key to uniquely identify a message.
    Example: "JOB_FINISHED"

  - `status.details.jsonPath` (string)
    JSONPath as specified by the IETF standard
    Example: "$.businessPartner.names[0].value"

  - `status.details.jsonRecord` (string)
    Object provided in plain JSON format.
    Example: "{ \"key\" : \"value\"}"

  - `status.path` (string)
    Requested path which caused this error.
    Example: "/v2/businesspartners/lookup"

  - `status.timestamp` (string)
    ISO 8601 representation of the timestamp.
    Example: "2025-08-27T14:26:38Z"