Summary
We’re excited to announce an upcoming upgrade to the company/dataset endpoint in KYC API v2, scheduled for release on April 16, 2025. This update introduces the super dataset, offering users more flexibility when retrieving company data, alongside the currently available datasets.
Upgrade of Company Dataset Endpoint
The GET /company/dataset endpoint is being enhanced to support a new dataset type: super, in addition to the already available datasets.
After the upgrade, the following dataset types will be available for a selected entity:
- refresh
- index
- super
The super dataset corresponds to the data source used in the enhanced endpoint when the generalData and suppressRefresh parameters are set to true. It also corresponds to the super dataset available in KYC API v1 via the endpoint GET /company/{id}/super/{country}.
For France, the super dataset is identical to the data returned by the enhanced endpoint when generalData, suppressRefresh, and stakeholders are set to true, as it is generated from two separate register sources.
Pricing
Pricing for the super dataset is detailed in our Coverage Details endpoint. (productName: super_data). The cost matches that of dataset orders via the enhanced endpoint where generalData and suppressRefresh are set to true, provided the kompanyId refers to an entity in a jurisdiction where super datasets are available.
Request
curl 'https://api.kompany.com/api/v2/company/dataset' \
-X POST \
-H "accept: application/json" \
-H "content-type: application/json" \
-H "user_key: *****" \
--data-binary '{"datasetName":"super","kompanyId":"defined_kompanyId"}'
Response
{
"datasetId": "{{sample_dataset_id}}",
"kompanyId": "{{sample_kompany_id}}",
"datasetName": "super",
"datasetOptions": null,
"info": null,
"status": "COMPLETED",
"requestTime": "2025-03-24T11:44:51+00:00",
"responseTime": "2025-03-24T11:44:54+00:00",
"estimatedDeliverySeconds": 1,
"content": {
"kompanyId": "{{sample_kompany_id}}",
"countryCode": "FR",
"countryName": "France",
"state": null,
"registrationNumber": "{{sample_registration_number}}",
"name": "{{sample_company_name}}",
"status": "CLOSED",
"providedStatus": null,
"address": "",
"legalForm": "SAS, société par actions simplifiée",
"additionalData": {
"otherIdentifiers": [
{
"identifierName": "localNumber",
"identifierValue": "{{sample_registration_number}}"
}
],
"branches": [
{
"address": [
"48",
" Sample Street",
" 92100",
" Sample City",
" FRANCE"
],
"formattedAddress": {
"number": "48",
"street": "Sample Street",
"city": "Sample City",
"country": "FRANCE"
}
},
{
"address": [
"25",
" Sample Avenue",
" 75008",
" Sample District",
" FRANCE"
],
"formattedAddress": {
"number": "25",
"street": "Sample Avenue",
"city": "Sample District",
"country": "FRANCE"
}
}
],
"shares": {
"shareCapitals": "6000.0",
"shareCurrency": "EUR"
},
"legalEvents": {
"registrationDate": "2014-06-19"
}
},
"associatedEntities": {
"shareholders": [],
"officers": [
{
"name": "JOHN DOE",
"role": "officer",
"providedRole": "Président de SAS",
"isCorporate": false,
"address": "FRANCE 00000 Sample City",
"dateOfBirth": "1970-01",
"nationality": "Française"
}
],
"ultimateBeneficialOwners": []
},
"industryActivityCode": {
"activity": "Sample business activities such as consulting, import/export, and vehicle sales."
},
"providerSpecificData": {
"latestAccounts": {
"overdue": false
}
},
"sources": [
{
"name": "National Business Register (Le Registre National des Enterprises - RNE)",
"info": null,
"primary": true,
"fields": [
"$.additionalData.shares.shareCurrency",
"$.status",
"$.legalForm",
"$.registrationNumber",
"$.additionalData.otherIdentifiers[0]",
"$.additionalData.shares.shareCapitals",
"$.additionalData.legalEvents.registrationDate",
"$.industryActivityCode.activity",
"$.name",
"$.associatedEntities.officers",
"$.additionalData.branches"
],
"lastCheckedTime": "2025-03-12T09:17:35+00:00"
},
{
"name": "Trade and Companies Register (Infogreffe)",
"info": null,
"primary": false,
"fields": [
"$.additionalData.shares.shareCurrency",
"$.status",
"$.legalForm",
"$.registrationNumber",
"$.additionalData.otherIdentifiers[0]",
"$.additionalData.shares.shareCapitals",
"$.additionalData.legalEvents.registrationDate",
"$.industryActivityCode.activity",
"$.name",
"$.associatedEntities.officers",
"$.additionalData.branches"
],
"lastCheckedTime": "2025-03-12T09:17:35+00:00"
}
],
"version": "company-v2.0"
}
}
For a comprehensive overview of the Company Dataset endpoints and their features, please refer to the Documentation
If you would like to provide us with feedback or you have a question related to this, contact us here: support team.