Fetch Business Partner

Fetch Business PartnerWSDL

Retrieves the Business Partner based on the Lookup and returning the result of the single record.

SecurityapiKey

Request

header Parameters

X-DNB-PASSWORD	string Dnb Consumer Secret. Example: dnb_consumer_key
X-DNB-USER	string Dnb Consumer Key. Example: dnb_consumer_key

Request Body schema:
application/json
required

cmd

cdqId

string

CDQ ID for Business Partner and address.

Example: "VIES:DE123456789"

featuresOff

Array of strings (BusinessPartnerFetchFeatures)

List of features to be deactivated.

Items Enum:	Description
ENABLE_SETTINGS	Enables settings for the lookup.
ACTIVATE_DATASOURCE_BVD	Enables BVD data source for the lookup.
ACTIVATE_DATASOURCE_DNB	Enables DNB data source for the lookup.

Example: ["[ \"ENABLE_SETTINGS\", \"LAB_ENABLE_BETA_FEATURES\" ]"]

featuresOn

Array of strings (BusinessPartnerFetchFeatures)

List of features to be activated.

Items Enum:	Description
ENABLE_SETTINGS	Enables settings for the lookup.
ACTIVATE_DATASOURCE_BVD	Enables BVD data source for the lookup.
ACTIVATE_DATASOURCE_DNB	Enables DNB data source for the lookup.

Example: ["[ \"ENABLE_SETTINGS\", \"LAB_ENABLE_BETA_FEATURES\" ]"]

Responses

200

201

Created

401

Unauthorized

403

Forbidden

404

Not Found

post/businesspartners/fetch

Request samples

Payload
curl
Python
Java
Node.js

{"cdqId": "VIES:DE123456789",
"featuresOn": ["[ \"ENABLE_SETTINGS\", \"LAB_ENABLE_BETA_FEATURES\" ]"
],
"featuresOff": ["[ \"ENABLE_SETTINGS\", \"LAB_ENABLE_BETA_FEATURES\" ]"
]
}

Response samples

{"dataSource": "648824a691d8d2503d65103e",
"businessPartner": {"names": [{"value": "Corporate Data Quality AG",
"shortname": "CDQ AG",
"language": "DE",
"type": {"name": "Local Name",
"technicalKey": "LOCAL",
"url": "https://meta.cdq.com/Business_partner/name/type"
}
}
],
"partnerProfile": {"phoneNumbers": [{"countryPrefix": "+41",
"number": "71 571 10 40",
"type": {"name": "FAX",
"url": "https://meta.cdq.com/Business_partner/partner_profile/phone_number/type"
},
"value": "+41 71 571 10 40"
}
],
"websites": ["https://cdq.com"
]
},
"identifiers": [{"value": "CHE-218.608.886 HR/MWST",
"issuingBody": "Amtsgericht Aachen",
"status": "ACTIVE",
"validFrom": "2025-02-20T19:03:49Z",
"validTo": "2025-02-20T19:03:49Z",
"type": {"name": "CH_VAT_ID",
"technicalKey": "CH_VAT_ID",
"url": "https://meta.cdq.com/Business_partner/identifier/type"
}
}
],
"legalForm": {"name": "Aktiengesellschaft",
"url": "https://meta.cdq.com/Business_partner/legal_form"
},
"classifications": [{"code": "20.20Z",
"label": "Manufacture of pesticides and other agrochemical products.",
"type": {"name": "NAF 2003",
"url": "https://meta.cdq.com/Business_partner/partner_profile/classification/type"
}
}
],
"categories": [{"name": "Hotel",
"url": "https://meta.cdq.com/Business_partner/category"
}
],
"status": {"type": {"name": "In Liquidation",
"url": "https://meta.cdq.com/Business_partner/status/type"
}
},
"addresses": [{"country": {"value": "Switzerland",
"shortname": "CH"
},
"postCode": {"value": "9000",
"shortname": "shortNamePostCode",
"type": {"name": "Regular",
"url": "https://meta.cdq.com/Address/post_code/type"
}
},
"localities": [{"value": "Sankt Gallen",
"shortname": "St. Gallen",
"type": {"name": "City",
"url": "https://meta.cdq.com/Address/locality/type"
}
}
],
"openingHours": ["09:00 AM - 05:00 PM"
],
"administrativeAreas": [{"value": "Sankt Gallen",
"shortname": "SG",
"type": {"name": "COUNTY",
"url": "https://meta.cdq.com/Address/administrative_area/type"
}
}
],
"thoroughfares": [{"value": "Lukasstraße 4",
"shortname": "Lukasstr. 4",
"direction": "221-bis Baker Street, North",
"number": "4",
"type": {"name": "Industrial zone",
"url": "https://meta.cdq.com/Address/thoroughfare/type"
}
}
],
"premises": [{"value": "Lukasstraße 4",
"shortname": "Lukasstr. 4",
"number": "4",
"type": {"name": "Factory",
"url": "https://meta.cdq.com/Address/premise/type"
}
}
],
"postalDeliveryPoint": {"value": "Postfach",
"shortname": "St Gallen, Postfach 460",
"number": "460",
"type": {"name": "Mailbox",
"url": "https://meta.cdq.com/Address/postal_delivery_point/type"
}
},
"geographicCoordinates": {"longitude": "9.395275",
"latitude": "47.439549"
},
"formattedAddress": {"country": "Switzerland",
"administrativeArea": "Sankt Gallen",
"region": "Sankt Gallen",
"regionCode": "9004",
"locality": "Sankt Gallen",
"district": "City center",
"postCode": "9000",
"thoroughfare": "Lukassstrasse",
"premise": "Lukasstraße 4, Building 2, Floor 3, Room 4",
"interurbanDeliveryPoint": "Sankt Gallen, Postfach 460",
"mailbox": "Postfach 460",
"mailStation": "US, Pasadena, MAIL STATION 201-6",
"postOfficeBox": "Postfach 460"
},
"types": [{"name": "Legal Address",
"url": "https://meta.cdq.com/Address/type"
}
],
"contexts": [{"value": "Production hall 7, Storage field 8."
}
],
"careOf": {"value": "CDQ GmbH c/o Product Department"
}
}
],
"types": [{"name": "Legal Entity",
"technicalKey": "LEGAL_ENTITY",
"url": "https://meta.cdq.com/Business_partner/type"
}
]
},
"rawRecord": [{"key": "key",
"value": "value"
}
]
}