Search Business Partners

V4 (beta)

What's New

Knowledge Base

Getting started

Knowledge-Base

Developer Guidelines

Tutorials

Instructions

API Catalogue

Bankaccount Data API

Data Clinic API

Data Compliance API

Data Curation API

Data Exchange API

Data Matching API

Data Validation API

Email Analysis API

Knowledge Graph API

Metadata API

Organization Management API

Product Identification API

Reference Data API

Resources

Batch Lookup

Bulk Fetch

Bulk Lookup

Business Partners

post

Create Supplier Gateway Record

post

Fetch Batch Business Partners

post

Fetch Business Partner

post

Fetch Business Partner Relations

post

Fetch DNB Record

post

Fetch Supplier Gateway Record

post

Generate Golden Record

post

Lookup Business Partners

post

Search Business Partners

get

Simplified Lookup Business Partners

Cancel Bulk

Configurations

Registrations

Vendor Extensions

Salesforce API

SAP DQM API

SAP ODM API

SAP BN API

Search Business Partners

Use for single queries to quickly find a Business Partner. User have to verify the results. To be used when Business Partner is not normalized e.g. Company Name and Address are in one line.

SecurityapiKey

Request

Request Body schema: application/json
required

cmd

page	integer (schemas-Page) >= 0 Default: 0 Current page number. Example: "1"
pageSize	integer (PageSize) [ 1 .. 1000 ] Number of items per page. Default 10. Example: "10"
query	string non-empty Pattern which will be used to search in multiple fields. Example: "CDQ Lukasstrasse 4, Sankt Gallen 9000"

Responses

200

401

Unauthorized

403

Forbidden

404

Not Found

post/v3/businesspartners/search

Request samples

Payload
curl
Python
Java
Node.js

application/json

{"query": "CDQ, 50-078 Wrocław"
}

Response samples

application/json

{"pageSize": "10",
"totals": "67",
"page": "1",
"values": [{"relevanceScore": "0.8",
"cdqId": "VIES:PL8660001429",
"dataSource": "648824a691d8d2503d65103e",
"businessPartner": {"names": [{"shortName": "CDQ AG",
"type": {"url": "https://meta.cdq.com/Business_partner/name/type",
"name": "Local Name",
"technicalKey": "LOCAL"
},
"value": "Corporate Data Quality AG",
"language": {"name": "German",
"technicalKey": "DE"
}
}
],
"legalForm": {"name": "Aktiengesellschaft",
"url": "https://meta.cdq.com/Business_partner/legal_form",
"language": {"name": "German",
"technicalKey": "DE"
},
"mainAbbreviation": "AG",
"cdlElfCode": "AG",
"categories": [{"name": "Limited Liability Company",
"shortName": "LLC",
"url": "https://meta.cdq.com/Business_partner/legal_form/category/technical_key/LF001",
"technicalKey": "LIMITED"
}
],
"technicalKey": "DE_9866"
},
"identifiers": [{"type": {"url": "https://meta.cdq.com/Business_partner/identifier/type",
"name": "CH_VAT_ID",
"technicalKey": "CH_VAT_ID"
},
"value": "CHE-218.608.886 HR/MWST",
"issuingBody": {"shortName": "Amtsgericht Aachen",
"name": "Amtsgericht Aachen",
"names": [null
],
"url": "https://meta.cdq.com/Business_partner/identifier/issuing_body",
"technicalKey": "Amtsgericht Aachen",
"jurisdiction": {"country": null,
"administrativeAreas": [ ]
}
},
"status": {"name": "ACTIVE",
"technicalKey": "ACTIVE"
}
}
],
"categories": [{"name": "Hotel",
"url": "https://meta.cdq.com/Business_partner/category",
"technicalKey": "HOTEL"
}
],
"status": {"officialDenotation": "Good Standing",
"validFrom": "2025-02-28T10:04:23Z",
"validUntil": "2025-02-28T10:04:23Z",
"type": {"name": "In Liquidation",
"url": "https://meta.cdq.com/Business_partner/status/type",
"technicalKey": "IN_LIQUIDATION"
}
},
"addresses": [{"version": {"characterSet": {"name": null,
"technicalKey": null
},
"language": {"name": null,
"technicalKey": null
}
},
"identifyingName": {"value": "John Doe"
},
"externalId": "1",
"metadata": {"primaryProvenance": {"name": null,
"url": null,
"technicalKey": null,
"cdqId": null
},
"language": {"name": null,
"technicalKey": null
}
},
"careOf": {"value": "CDQ GmbH c/o Product Department"
},
"contexts": [{"value": null
}
],
"country": {"shortName": "CH",
"value": "Switzerland"
},
"administrativeAreas": ["Sankt Gallen"
],
"postCodes": [{"value": null,
"type": null
}
],
"localities": [{"type": null,
"shortName": null,
"value": null,
"language": null
}
],
"thoroughfares": [{"type": null,
"shortName": null,
"number": null,
"value": null,
"name": null,
"direction": null,
"language": null
}
],
"premises": [{"value": null,
"shortName": null,
"number": null,
"type": null,
"language": null
}
],
"postalDeliveryPoints": [{"type": null,
"shortName": null,
"number": null,
"value": null,
"language": null
}
],
"geographicCoordinates": {"latitude": "47.439549",
"longitude": "9.395275"
},
"types": [{"name": null,
"url": null,
"technicalKey": null
}
],
"formattedAddress": {"country": "Switzerland",
"administrativeArea": "Sankt Gallen",
"region": "Sankt Gallen",
"regionCode": "9004",
"locality": "Sankt Gallen",
"district": "City center",
"postalCode": "9000",
"thoroughfare": "Lukassstrasse",
"premise": "Lukasstraße 4, Building 2, Floor 3, Room 4",
"interurbanDeliveryPoint": "Sankt Gallen, Postfach 460",
"mailbox": "Postfach 460",
"postOfficeBox": "Postfach 460"
}
}
],
"externalId": "The ID managed in the customer's SAP systems.",
"profile": {"minorityIndicator": {"value": "Social enterprise"
},
"classifications": [{"value": "Manufacture of pesticides and other agrochemical products.",
"code": "20.20Z",
"type": {"name": null,
"url": null
}
}
],
"phoneNumbers": [{"countryPrefix": "+41",
"number": "71 571 10 40",
"type": {"name": null,
"url": null
},
"value": "+41 71 571 10 40"
}
],
"websites": [{"url": "https://cdq.com",
"type": {"name": null,
"url": null,
"technicalKey": null
}
}
],
"contactEmails": [{"value": "developer-portal@cdq.com"
}
],
"tags": [{"value": "Warehouse",
"type": {"technicalKey": null
}
}
],
"vatPayerStatus": {"publicationDate": "2025-02-28T10:04:23Z",
"status": {"name": "RELIABLE",
"technicalKey": "VAT_PAYER_STATUS"
},
"registrationAuthority": {"registrationAuthorityId": "RA000009",
"registrationAuthorityEntityId": "RA000009",
"otherRegistrationAuthorityId": "RA000009"
}
},
"hcpProfile": {"generalLicense": {"professionType": {"name": null,
"url": null,
"technicalKey": null
},
"licenseStatus": {"name": null,
"url": null,
"technicalKey": null
}
},
"operationalPermissions": [{"issuingAuthority": null,
"permissionStatus": null,
"activityStatus": null,
"practiceLocations": [ ]
}
]
}
},
"formattedSapRecord": {"name1": "CDQ AG",
"name2": "CDQ AG",
"name3": "CDQ AG",
"name4": "CDQ AG",
"nameCo": "Aktiengesellschaft",
"legalEntity": "Aktiengesellschaft",
"legalForm": "Aktiengesellschaft",
"indSector": "NAF",
"indSectorCode": "NAF",
"emailAddress": "bp@gmail.com",
"narp": "Friedrich Nietzsche",
"stceg": "CHE-218.608.88",
"stcd1": "CHE-218.608.88",
"stcd2": "CHE-218.608.88",
"stcd3": "CHE-218.608.88",
"stcd4": "CHE-218.608.88",
"stcd5": "CHE-218.608.88",
"url": "www.cdq.com",
"telNumber": "+41 71 571 10 40",
"country": "Switzerland",
"countryCode": "CH",
"region": "Sankt Gallen",
"regionCodeSap": "9004",
"regionCode": "9004",
"county": "Sankt Gallen",
"countyCode": "9004",
"township": "Sankt Gallen",
"townshipCode": "9004",
"city": "Sankt Gallen",
"district": "St. Georgen",
"postalCode": "9000",
"postalCode3": "9000",
"street1": "Lukasstraße 4",
"street2": "Lukasstraße 4",
"street5": "Lukasstraße 4",
"houseNum": "4",
"houseNum2": "4",
"building": "Office 2",
"floor": "2",
"roomnumber": "123",
"poBoxCountry": "9000",
"poBoxCity": "9000",
"poBoxPostalCode": "9000",
"poBox": "9000",
"latitude": "47.439549",
"longitude": "9.395275"
},
"relations": [{"startedAt": "2025-02-28T10:04:23Z",
"endedAt": "2025-02-28T10:04:23Z",
"type": {"name": "Commercial ultimate",
"url": "https://meta.cdq.com/Business_partner/relation/type",
"technicalKey": "COMMERCIAL_ULTIMATE"
},
"class": {"name": "CDQ Hierarchy",
"url": "https://meta.cdq.com/Business_partner/relation/class",
"technicalKey": "BUSINESS_PARTNER_RELATION_CLASS_CDQ_HIERARCHY"
},
"startNode": "FR.RC:5664645",
"endNode": "FR.RC:5664645",
"startNodeBusinessPartner": {"names": [null
],
"addresses": [null
]
},
"endNodeBusinessPartner": {"names": [null
],
"addresses": [null
]
}
}
],
"types": [{"name": "Legal Entity",
"url": "https://meta.cdq.com/Business_partner/type",
"technicalKey": "LEGAL_ENTITY"
}
],
"externalContext": {"identifiers": [{"value": "7250017031",
"type": {"technicalKey": null
}
}
]
},
"jsonRecord": { },
"bankAccounts": [{"internationalBankAccountIdentifier": "CH8800781619278412000",
"internationalBankIdentifier": "KBSGCH22XXX",
"nationalBankAccountIdentifier": "619278412000",
"nationalBankIdentifier": "00781",
"countryCode": "DE"
}
]
}
}
]
}

Search Business Partners

Request Body schema: application/jsonrequired

Request Body schema: application/json
required