# Create Bulk Curation

Create a bulk to curate multiple business partners at a time.

Endpoint: POST /v3/businesspartners/curate/bulks
Version: 3
Security: apiKey

## Request fields (application/json):

  - `outputLanguage` (object)
    Expected language of curation result, compliant to ISO 639-1.

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

  - `addressDataSources` (object)
    Preferred data sources for curation. Default PrimaryAddressDataSource is HERE. Default SecondaryAddressDataSource is CDQ.

  - `addressDataSources.primaryAddressDataSource` (object)
    Preferred Data Source for curation.

  - `addressDataSources.primaryAddressDataSource.technicalKey` (string, required)
    Technical key for Address Data Source.
    Enum: "CDQ", "HERE", "GOOGLE_MAPS"

  - `addressDataSources.primaryAddressDataSource.threshold` (number)
    Threshold for the address data source. The threshold is a value between 0.0 and 1.0.
    Example: "0.4"

  - `addressDataSources.secondaryAddressDataSources` (array)
    Ordered list of secondary preferred Data Sources.

  - `profile` (string)
    Used to configure the curation process.
Available wiki documentation for profiles:
   * [STANDARD](https://meta.cdq.com/API/Data_Curation_API/Profile/STANDARD)
   * [ADDRESS_ONLY](https://meta.cdq.com/API/Data_Curation_API/Profile/ADDRESS_ONLY)
   * [STANDARD_ADDRESS_CURATION_AND_ENRICHMENT](https://meta.cdq.com/API/Data_Curation_API/Profile/STANDARD_ADDRESS_CURATION_AND_ENRICHMENT)
   * [ADDRESS_STANDARDIZATION](https://meta.cdq.com/API/Data_Curation_API/Profile/ADDRESS_STANDARDIZATION)
   * [ADDRESS_TRANSLATION](https://meta.cdq.com/API/Data_Curation_API/Profile/ADDRESS_TRANSLATION)
   * [BUSINESS_PARTNER_ONLY](https://meta.cdq.com/API/Data_Curation_API/Profile/BUSINESS_PARTNER_ONLY)
   * [FEATURES_OFF](https://meta.cdq.com/API/Data_Curation_API/Profile/FEATURES_OFF)
   * [NATURAL_PERSON_SCREENING](https://meta.cdq.com/API/Data_Curation_API/Profile/NATURAL_PERSON_SCREENING)
   * [PRECURATION](https://meta.cdq.com/API/Data_Curation_API/Profile/PRECURATION)
   * [GOLDEN_RECORD](https://meta.cdq.com/API/Data_Curation_API/Profile/GOLDEN_RECORD)
    Enum: "STANDARD", "ADDRESS_ONLY", "STANDARD_ADDRESS_CURATION_AND_ENRICHMENT", "ADDRESS_STANDARDIZATION", "ADDRESS_TRANSLATION", "BUSINESS_PARTNER_ONLY", "FEATURES_OFF", "NATURAL_PERSON_SCREENING", "PRECURATION", "GOLDEN_RECORD"

  - `featuresOn` (array)
    List of feature to be activated.
    Enum: "ACTIVATE_DATASOURCE_BVD", "ACTIVATE_DATASOURCE_DNB", "ALL_ADDRESS_VERSIONS", "CAPITALIZE_ADDRESS", "CONFIRM_IDENTIFIERS", "DETECT_INDUSTRIAL_ZONE", "ENABLE_FUZZY_ENRICHMENTS", "ENABLE_SETTINGS", "ENABLE_UNALLOWED_NAME_VALUE_VALIDATION", "ENRICH_ADDRESS", "ENRICH_ADDRESS_TYPE", "ENRICH_ADMINISTRATIVE_AREA_ISO", "ENRICH_CATEGORY", "ENRICH_CLASSIFICATIONS", "ENRICH_COMPANY_STATUS", "ENRICH_GEOGRAPHIC_COORDINATES", "ENRICH_GOOGLE_PLACES_INFORMATION", "ENRICH_IDENTIFIERS", "ENRICH_LEGAL_ADDRESS", "ENRICH_LOCAL_ADDRESS", "ENRICH_LEGAL_FORM", "ENRICH_MINORITY_INDICATOR", "ENRICH_POST_CODE_TYPE", "ENRICH_POST_CODE", "ENRICH_REGISTERED_NAME", "ENRICH_VAT_REGISTERED_INFORMATION", "EXTRACT_ADDRESS_CONTEXT", "EXTRACT_CARE_OF", "EXTRACT_DOING_BUSINESS_AS", "EXTRACT_NAME_DETAILS", "HARMONIZE_IDENTIFIERS", "HARMONIZE_NAME", "JOIN_THOROUGHFARE_NUMBER_POSTFIX", "JOIN_THOROUGHFARE_NUMBER_PREFIX", "IDENTIFY_TYPE", "NORMALIZE_ADDRESS", "NORMALIZE_BUSINESS_PARTNER", "PARSE_ADDRESS", "PARSE_LEGAL_FORM", "PARSE_LEGAL_FORM_WORLDWIDE", "PARSE_NAMES", "PERSIST_LOOKUP_RESULTS", "PREFER_COUNTY", "PREFER_THOROUGHFARE_NAME", "PREFER_THOROUGHFARE_SHORTNAME", "PREPROCESS_ADDRESS", "PREPROCESS_BUSINESS_PARTNER", "REMOVE_CONTACT_INFORMATION", "REMOVE_INVALID_IDENTIFIERS", "SELECT_PRIMARY_ADDRESS", "SHARING_PRIMARY", "SHOW_DEBUG_INFO", "SHOW_FORMATTED_ADDRESS", "SHOW_FORMATTED_SAP_RECORD", "SHOW_SETTINGS", "STANDARDIZE_REGISTERED_ADDRESS", "STANDARDIZE_VAT_REGISTERED_ADDRESS", "TRANSLATE_ADDRESS", "TRANSLATE_NAMES", "USE_ADDRESS_INDEX_KR", "USE_LOCALITY_SHORTNAME_REFERENCE"

  - `featuresOff` (array)
    List of feature to be deactivated.
    Enum: "ACTIVATE_DATASOURCE_BVD", "ACTIVATE_DATASOURCE_DNB", "ALL_ADDRESS_VERSIONS", "CAPITALIZE_ADDRESS", "CONFIRM_IDENTIFIERS", "DETECT_INDUSTRIAL_ZONE", "ENABLE_FUZZY_ENRICHMENTS", "ENABLE_SETTINGS", "ENABLE_UNALLOWED_NAME_VALUE_VALIDATION", "ENRICH_ADDRESS", "ENRICH_ADDRESS_TYPE", "ENRICH_ADMINISTRATIVE_AREA_ISO", "ENRICH_CATEGORY", "ENRICH_CLASSIFICATIONS", "ENRICH_COMPANY_STATUS", "ENRICH_GEOGRAPHIC_COORDINATES", "ENRICH_GOOGLE_PLACES_INFORMATION", "ENRICH_IDENTIFIERS", "ENRICH_LEGAL_ADDRESS", "ENRICH_LOCAL_ADDRESS", "ENRICH_LEGAL_FORM", "ENRICH_MINORITY_INDICATOR", "ENRICH_POST_CODE_TYPE", "ENRICH_POST_CODE", "ENRICH_REGISTERED_NAME", "ENRICH_VAT_REGISTERED_INFORMATION", "EXTRACT_ADDRESS_CONTEXT", "EXTRACT_CARE_OF", "EXTRACT_DOING_BUSINESS_AS", "EXTRACT_NAME_DETAILS", "HARMONIZE_IDENTIFIERS", "HARMONIZE_NAME", "JOIN_THOROUGHFARE_NUMBER_POSTFIX", "JOIN_THOROUGHFARE_NUMBER_PREFIX", "IDENTIFY_TYPE", "NORMALIZE_ADDRESS", "NORMALIZE_BUSINESS_PARTNER", "PARSE_ADDRESS", "PARSE_LEGAL_FORM", "PARSE_LEGAL_FORM_WORLDWIDE", "PARSE_NAMES", "PERSIST_LOOKUP_RESULTS", "PREFER_COUNTY", "PREFER_THOROUGHFARE_NAME", "PREFER_THOROUGHFARE_SHORTNAME", "PREPROCESS_ADDRESS", "PREPROCESS_BUSINESS_PARTNER", "REMOVE_CONTACT_INFORMATION", "REMOVE_INVALID_IDENTIFIERS", "SELECT_PRIMARY_ADDRESS", "SHARING_PRIMARY", "SHOW_DEBUG_INFO", "SHOW_FORMATTED_ADDRESS", "SHOW_FORMATTED_SAP_RECORD", "SHOW_SETTINGS", "STANDARDIZE_REGISTERED_ADDRESS", "STANDARDIZE_VAT_REGISTERED_ADDRESS", "TRANSLATE_ADDRESS", "TRANSLATE_NAMES", "USE_ADDRESS_INDEX_KR", "USE_LOCALITY_SHORTNAME_REFERENCE"

  - `outputCharsets` (array)
    List of Output Character Sets.

  - `outputCharsets.concept` (string, required)
    Concept for which the output character set should be applied.
    Enum: "ADDRESS"

  - `outputCharsets.charset` (string, required)
    Supported CharacterSets:
* [INTERNATIONAL](https://meta.cdq.com/Address/version/character_set/international)
* [LATIN](https://meta.cdq.com/Address/version/character_set/latin)
* [WESTERN_LATIN_STANDARD](https://meta.cdq.com/Address/version/character_set/western_latin_standard)
* [ASCII](https://meta.cdq.com/Address/version/character_set/ascii)

Deprecated CharacterSets:
* LATIN_1. Now: [WESTERN_LATIN_STANDARD](https://meta.cdq.com/Address/version/character_set/western_latin_standard)
* UTF8. Now: [INTERNATIONAL](https://meta.cdq.com/Address/version/character_set/international)
    Enum: "INTERNATIONAL", "LATIN", "LATIN_1", "UTF8", "WESTERN_LATIN_STANDARD", "ASCII"

  - `addressCurationLevelThreshold` (string)
    Indicator for curation quality. Defines how good curation was.

Determines  based on  of the result. 
Additional documentation can be found [here](https://meta.cdq.com/Quality_indicator/address_cleansing_curation_level#Curation_level).
    Enum: "UNKNOWN", "LEVEL_1", "LEVEL_2", "LEVEL_3", "LEVEL_4", "LEVEL_5", "LEVEL_6"

  - `configurationId` (string)
    Configuration ID used to set up curation. If provided, those parameters will be affected.
If any of them is provided in this request, will overwrite one from configuration (except for features which are merged):
* 
* 
* 
* 
* 
* 
* 
* 
*
    Example: "5c5356588c72a028c448adbd"

  - `numberSeparator` (object)
    Number separator for features JOIN_THOROUGHFARE_NUMBER_PREFIX, JOIN_THOROUGHFARE_NUMBER_POSTFIX. Default ","

  - `numberSeparator.value` (string)
    Character used to separate numbers.
    Example: ","

  - `inputAddressConceptsIgnored` (array)
    A list of technical keys of concepts. Selected concepts will be ignored during curation process. 
This feature is mainly used in configurations, if i.e. for certain countries selected inputs 
should be ignored without changing the current technical integration. 
Please note that ignored concepts will be taken over to the curation result without any change.
    Enum: "BUILDING", "CITY", "COUNTY", "DISTRICT", "LEVEL", "POST_CODE", "REGION", "ROOM", "THOROUGHFARE_NUMBER"

  - `tasks` (array, required)
    List of tasks to be executed.

  - `tasks.businessPartner` (object)
    Additional documentation can be found [here](https://meta.cdq.com/Business_partner).

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

  - `tasks.businessPartner.names` (array)

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

  - `tasks.businessPartner.names.type` (object)
    Allowed types are documented [here](https://meta.cdq.com/Business_partner/name/type).

  - `tasks.businessPartner.names.type.technicalKey` (string)
    Allowed types are documented [here](https://meta.cdq.com/Business_partner/name/type) under Technical Key property.
    Enum: "ACRONYM", "DOING_BUSINESS_AS", "INTERNATIONAL", "LOCAL", "OTHER", "REGISTERED", "REGISTERED_NAME", "TRANSLITERATED", "TRANSLITERATED_NAME", "VAT_REGISTERED", "VAT_REGISTERED_NAME"

  - `tasks.businessPartner.identifiers` (array)

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

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

  - `tasks.businessPartner.identifiers.type.technicalKey` (string)
    Allowed types are documented [here](https://meta.cdq.com/Category:Business_partner/identifier/type) under Technical Key property.
    Enum: "ABN_AU", "ACN_AU", "AD_FI_CODE", "AE_BRN", "AE_CCN", "AE_VAT", "AL_BRN", "AL_TRN", "AM_BRN", "AM_COC", "AM_GGN", "AM_TRN", "ANID", "AO_BRN", "AO_TIN", "AR_AGENT_NO", "AR_CUIL", "AR_CUIT", "AR_IATAIN", "AR_NIP", "AR_PGRTN", "AR_SEN", "AR_UTIK", "AT_ARN", "AZ_BRN", "AZ_CCN", "AZ_GGN", "AZ_TRN", "AZ_VAT", "BAN_US_CH", "BAN_US_SF", "BA_BRN", "BA_COC", "BA_GGN", "BA_TRN", "BD_CIN", "BD_TIN", "BE_ARN", "BE_BUN", "BE_ENT_NO", "BE_VAT_ID", "BF_BRN", "BG_BRN", "BG_CCN", "BG_GGN", "BG_SEC_ID", "BG_TAX_ID", "BG_UID", "BH_BRN", "BH_CCN", "BH_VAT", "BIC", "BIC_FI", "BI_BRN", "BI_US_AK", "BI_US_CO", "BI_US_CT", "BJ_BRN", "BN_CA", "BN_TIN", "BO_NIT", "BR_CNPJ", "BR_CPF", "BR_GRT", "BR_ID_AT", "BR_SUF", "BR_TAX_MUN", "BR_TAX_STATE", "BT_TIN", "BVD_ID", "BW_BRN", "BY_BRN", "BY_COC", "BY_GGN", "BY_TRN", "CA_CNUM", "CDN_US_FL", "CDQ_GR", "CDQ_ID", "CDQ_POOL_ID", "CF_BRN", "CG_BRN", "CH_EHRA_ID", "CH_ESTV_ID", "CH_OID", "CH_UID", "CH_VAT_ID", "CI_BRN", "CI_CCN", "CI_TRN", "CID_NY_US", "CIF_ES", "CIK_US", "CL_RUT", "CM_BRN", "CM_CCN", "CM_TRN", "CN_BRN", "CN_IE", "CN_JP", "CN_US_DC", "CN_US_IA", "CN_VAT_15", "CO_NIT", "CR_CPJ", "CREFO_ID", "CREFO_IDENT", "CRIF_ID", "CS_BRN", "CS_CCN", "CS_GGN", "CS_TRN", "CUSIP_9", "CVR_DK", "CV_BRN", "CX_BPN", "CX_POOL_ID", "CY_BRN", "CY_CCN", "CY_GGN", "CY_TRN", "CZ_CBN", "CZ_DIC", "CZ_ICO", "CZ_TRN", "DE_BNUM", "DE_TAX_AUTHORITY_ID", "DE_TAX_ID", "DE_TAX_OFFICE_NUMBER", "DJ_BRN", "DO_RNC", "DUNS_ID", "DUNS_ID_CU", "DUNS_ID_DU", "DUNS_ID_GU", "DZ_BRN", "DZ_CCN", "DZ_TRN", "EC_RUC", "EE_BRN", "EE_COC", "EE_GGN", "EE_TRN", "EG_BRN", "EG_CCN", "EG_TRN", "EID_US_VA", "EN_US_CA", "EORI", "ES_IRUS", "ES_NIE", "ES_NIF", "ET_BRN", "EU_CUST_REF", "EU_ID", "EU_VAT_ID", "EU_VAT_ID_AT", "EU_VAT_ID_BE", "EU_VAT_ID_BG", "EU_VAT_ID_CY", "EU_VAT_ID_CZ", "EU_VAT_ID_DE", "EU_VAT_ID_DK", "EU_VAT_ID_EE", "EU_VAT_ID_EL", "EU_VAT_ID_ES", "EU_VAT_ID_FI", "EU_VAT_ID_FR", "EU_VAT_ID_HR", "EU_VAT_ID_HU", "EU_VAT_ID_IE", "EU_VAT_ID_IT", "EU_VAT_ID_LT", "EU_VAT_ID_LU", "EU_VAT_ID_LV", "EU_VAT_ID_MT", "EU_VAT_ID_NL", "EU_VAT_ID_PL", "EU_VAT_ID_PT", "EU_VAT_ID_RO", "EU_VAT_ID_SE", "EU_VAT_ID_SI", "EU_VAT_ID_SK", "EU_VAT_ID_UK", "EU_VAT_ID_XI", "FID_US_WY", "FIN_US_PA", "FK_BRN", "FO_FIN", "FO_FPN", "FO_FVN", "FRC_RO", "FR_ANA", "FR_CCN", "FR_RNA", "FR_SIREN", "FR_SIRET", "GA_BRN", "GA_CCN", "GA_TRN", "GE_BRN", "GE_COC", "GE_GGN", "GE_TRN", "GH_BRN", "GH_TRN", "GI_BRN", "GI_CCN", "GI_GGN", "GI_TRN", "GL_CPR", "GL_GER", "GM_BRN", "GN_BRN", "GOOGLE_PLACE_ID", "GOOGLE_PLUS_CODE", "GQ_BRN", "GR_AFM", "GR_BRN", "GR_COC", "GR_GGN", "GR_PERS_ID", "GR_TRN", "GS1_GLN", "GST_CA", "GST_MY", "GT_NIT", "GW_BRN", "HK_BRN", "HK_CRN", "HN_NTRN", "HR_BRN", "HR_COC", "HR_COMP_ID", "HR_GGN", "HR_OIB", "HST_CA", "HU_CRN", "HU_TAX_ID", "HU_TIN", "ID_CRN", "ID_GST", "ID_NL_OB", "ID_TIN", "ID_TVA_FR", "ID_TVA_LU", "ID_UTR", "ID_VAT_UK", "IL_VAT", "IN_CIN", "IN_GST", "IN_IEC", "IN_LBT", "IN_LLPIN", "IN_PAN", "IN_SERVICE_TAX_ID", "IN_SRN", "IN_UDYAM", "IPEDS_ID", "IQ_BRN", "IR_BRN", "IR_CCN", "IS_BRN", "IS_CCN", "IS_GGN", "IS_IIN", "IS_VAT", "ISIN", "IT_FISC_ID", "IT_REA", "IT_VAT_ID", "JE_SSN", "JE_TRN", "JM_TIN", "JO_BRN", "JO_CCN", "JO_GST", "JP_JCT", "KE_BRN", "KE_PIN", "KE_VAT", "KG_BRN", "KG_COC", "KG_GGN", "KG_TRN", "KH_BRN", "KH_TIN", "KM_BRN", "KR_CORP_ID", "KR_CRBN", "KR_RES_ID", "KR_VAT_ID", "KVK_NL", "KW_BRN", "KW_CCN", "KZ_IIN", "LA_TIN", "LB_BRN", "LB_CCN", "LEI_ID", "LI_BRN", "LID_US_CH", "LIN_US_DE", "LIN_US_CH", "LIN_US_LA", "LIN_US_SF", "LK_TIN", "LR_BRN", "LS_BRN", "LT_BRN", "LT_COC", "LT_GGN", "LT_TRN", "LU_RCS", "LV_COC", "LV_BRN", "LV_GGN", "LV_TRN", "MA_CCN", "MA_ICE", "MA_TRN", "MD_BRN", "MD_COC", "MD_GGN", "MD_TRN", "ME_GGN", "ME_TRN", "MG_BRN", "MK_BRN", "MK_TRN", "ML_BRN", "MM_TIN", "MO_CRBRN", "MR_BRN", "MT_BRN", "MT_COC", "MT_GGN", "MT_TRN", "MU_BRN", "MU_TRN", "MV_TIN", "MW_BRN", "MX_CDQ_ID", "MX_CURP", "MX_RFC", "MY_BRN", "MY_SST", "MZ_BRN", "NA_BRN", "NE_BRN", "NG_BRN", "NG_TIN", "NL_BSN", "NL_SI_ID", "NL_TAX_ID", "NO_ORGID", "NP_TIN", "NZ_BN", "NZ_GST", "OM_BRN", "OM_CCN", "OPENCORP_ID", "ORBIS_ID", "PA_RUC", "PE_RUC", "PEPPOL_ID", "PH_TAX_ID", "PIC_ID", "PK_CNIC", "PK_TIN", "PL_KRS", "PL_NIP", "PL_REG", "PL_TAX_ID", "PST_CA", "PST_CA_MB", "PST_CA_SK", "PT_NIF", "PT_NIPC", "PY_RUC", "QA_BRN", "QA_CCN", "QST_CA", "RIAD", "RN_US_OR", "RO_BRN", "RO_CCN", "RO_GGN", "RO_TAX_ID", "RSIN_NL", "RS_BRN", "RS_PIB", "RU_BRN", "RU_CCN", "RU_GGN", "RU_INN", "RU_KPP", "RU_OFK", "RU_OKPO", "RU_TRN", "RW_BRN", "SA_BRN", "SA_CCN", "SA_VAT", "SC_BRN", "SC_CCN", "SCI_ID", "SD_BRN", "SE_ORG_ID", "SG_GST", "SG_UEN", "SH_BRN", "SI_BRN", "SI_CCN", "SI_GGN", "SI_TAX_ID", "SK_DIC", "SK_ICO", "SK_TRN", "SL_BRN", "SM_COE", "SM_SSI", "SN_BRN", "SN_CCN", "SN_TRN", "SPCOMP_ID", "SPOR_LOC_ID", "SPOR_ORG_ID", "SV_NIT", "SY_BRN", "SY_CCN", "SZ_BRN", "TD_BRN", "TG_BRN", "TH_PERS_ID", "TH_TAX_ID", "TIN_EG", "TJ_BRN", "TJ_COC", "TJ_GGN", "TJ_TRN", "TL_TIN", "TM_BRN", "TM_COC", "TM_GGN", "TM_TRN", "TN_TVA", "TR_BRN", "TR_CCN", "TR_GGN", "TR_TAX_ID", "TR_TAX_OFFICE_ID", "TRN_RO", "TT_TIN", "TW_BRN", "TW_GUID", "TW_TAX_ID", "TZ_BRN", "UA_BRN", "UA_CCN", "UA_GGN", "UA_TAX_ID", "UA_USREOU", "UA_VAT_ID", "UBI_US_WS", "UG_BRN", "UI_US_SF", "UK_DRV_LIC", "UK_IN_ID", "UK_NHS_ID", "UK_RCN", "US_BRN", "US_DEA", "US_EMPL_ID", "US_FTIN", "US_NPI", "US_SAM_ID", "US_SEC_ID", "UY_UTR", "UZ_BRN", "UZ_COC", "UZ_GGN", "UZ_TRN", "VAT_ID_NO", "VEN_NL", "VE_NIT", "VE_RIF", "VN_BRN", "VN_TIN", "VN_VAT", "WR_BTRN", "WR_CAGE", "WR_CINS", "WR_CUSIP", "XK_BRN", "XK_GGN", "YE_BRN", "YE_CCN", "ZA_CRN", "ZA_TIN", "ZA_VAT", "ZER_CDQ_ID", "ZM_BRN", "ZM_TRN", "ZM_VAT", "ZW_BRN", "ZW_COC", "ZW_GGN", "ZW_TRN"

  - `tasks.businessPartner.identifiers.issuingBody` (object)
    Additional documentation can be found [here](https://meta.cdq.com/Business_partner/identifier/issuing_body).

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

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

  - `tasks.businessPartner.addresses` (array)

  - `tasks.businessPartner.addresses.country` (object)
    Additional documentation can be found [here](https://meta.cdq.com/Address/country).

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

  - `tasks.businessPartner.addresses.administrativeAreas` (array)

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

  - `tasks.businessPartner.addresses.localities` (array)

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

  - `tasks.businessPartner.addresses.postCodes` (array)

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

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

  - `tasks.businessPartner.addresses.postCodes.type.technicalKey` (string)
    Allowed types are documented [here](https://meta.cdq.com/Address/post_code/type) under Technical Key property.
    Enum: "CEDEX", "REGULAR"

  - `tasks.businessPartner.addresses.thoroughfares` (array)

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

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

  - `tasks.businessPartner.addresses.premises` (array)

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

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

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

  - `tasks.businessPartner.addresses.premises.type.technicalKey` (string)
    Allowed types are documented [here](https://meta.cdq.com/Address/premise/type) under Technical Key property.
    Enum: "APARTMENT", "BUILDING", "DOOR", "FACTORY", "HARBOUR", "INDUSTRIAL_ZONE", "LEVEL", "ROOM", "SQUARE", "SUITE", "UNIT", "WAREHOUSE"

  - `tasks.businessPartner.addresses.postalDeliveryPoints` (array)

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

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

  - `tasks.businessPartner.addresses.postalDeliveryPoints.type` (object)
    Allowed types are documented [here](https://meta.cdq.com/Address/postal_delivery_point/type).

  - `tasks.businessPartner.addresses.postalDeliveryPoints.type.technicalKey` (string)
    Allowed types are documented [here](https://meta.cdq.com/Address/postal_delivery_point/type) under Technical Key property.
    Enum: "INTERURBAN_DELIVERY_POINT", "MAIL_STATION", "MAILBOX", "POST_OFFICE_BOX"

  - `tasks.businessPartner.addresses.careOf` (object)
    Additional documentation can be found [here](https://meta.cdq.com/Address/care_of).

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

  - `tasks.businessPartner.addresses.contexts` (array)

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

## Response 200 fields (application/json):

  - `id` (string)
    Unique identifier for a set of bulk tasks.
    Example: "650b12ac-3768-11ee-be56-0242ac120002"

  - `createdAt` (string)
    Date of creation (ISO 8601-compliant).
    Example: "2025-11-24T09:36:10Z"

  - `finishedAt` (string)
    Date of finish (ISO 8601-compliant).
    Example: "2025-11-24T09:36:10Z"

  - `createdBy` (string)
    Creator of a resource.
    Example: "76248934691294444"

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

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

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

  - `status.details` (array)

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

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

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

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

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

  - `status.timestamp` (string)
    ISO 8601 representation of the timestamp.
    Example: "2025-11-24T09:36:10Z"

  - `progress` (integer)
    Progress (%) of the bulk execution.
    Example: "77"