Developer news
KYC API: Upcoming changes to our connection to the German register
Posted 2025-07-21
|
Updated 2025-07-23
Summary
We would like to inform you that we have scheduled the implementation of the following changes to our connection with Handelsregister on KYC API, available with the 3rd of September 2025’s release.
Dataset availability
To enhance the stability and efficiency of our service, we will be merging the super dataset into the refresh dataset as of the September 3rd, 2025 release — going forward, only the refresh dataset will be available for your use.
This adjustment, made in response to client feedback and improved stability, ensures that all existing data fields remain accessible with no changes to mapped data. Additionally, by consolidating calls, we are able to reduce operational costs, while maintaining our commitment to providing German data at no additional charge.
Data refinement
Please note that, in line with our commitment to providing data as close to the original source as possible, we are adopting changes made by the German register. The register has transitioned partially to the English language, resulting in the field extraData.providedStatus / providedStatus now being supplied in English rather than German by default.
Please find the before and after responses per dataset below. Kindly note that the example companies mentioned are fictitious, and the availability of data fields in the mock-up is subject to the specific requirements of legal forms.
Response before for refresh dataset
{
"datasetId": "6881713701AA02710F48AC78C460EA5F",
"kompanyId": "42C2B3AB8AC7B11CCC435B42DCB4AED5",
"datasetName": "refresh",
"datasetOptions": null,
"info": null,
"status": "COMPLETED",
"requestTime": "2025-04-02T09:32:30+00:00",
"responseTime": "2025-04-02T09:32:45+00:00",
"estimatedDeliverySeconds": 32,
"content": {
"kompanyId": "42C2B3AB8AC7B11CCC435B42DCB4AED5",
"countryCode": "DE",
"countryName": "Germany",
"state": null,
"registrationNumber": "HRB41217 MAINZ",
"name": "DATAGROUP Consulting Services GmbH",
"status": "LIVE",
"providedStatus": null,
"address": "Genfer Allee 2, 55129 Mainz",
"legalForm": "Gesellschaft mit beschränkter Haftung",
"additionalData": {
"otherIdentifiers": [
{
"identifierName": "localNumber",
"identifierValue": "HRB44217 MAINZ"
}
],
"contactInformation": {
"formattedAddress": {
"number": "2",
"street": "Genfer Allee",
"zip": "55129",
"city": "Mainz"
}
},
"shares": {
"shareCapitals": "1.020.000,00",
"shareCurrency": "EUR"
},
"legalEvents": {
"incorporationDate": "2012-09-27"
},
"registerCourt": "DE/MAINZ"
},
"associatedEntities": {
"shareholders": [],
"officers": []
},
"industryActivityCode": null,
"providerSpecificData": {
"latestAccounts": {
"overdue": false
}
},
"sources": [
{
"name": "The Register Portal of the German Federal States (Handelsregister)",
"info": null,
"primary": true,
"fields": [
"$.additionalData.shares.shareCurrency",
"$.status",
"$.additionalData.legalEvents.incorporationDate",
"$.legalForm",
"$.registrationNumber",
"$.additionalData.otherIdentifiers[0]",
"$.additionalData.shares.shareCapitals",
"$.name",
"$.additionalData.contactInformation.formattedAddress"
],
"lastCheckedTime": "2025-04-02T09:32:45+00:00"
}
],
"version": "company-v2.0"
}
}
Response before for enhanced request
{
"datasetId": "3007358AAD7E7CB757B6F3889134303F",
"kompanyId": "42C2B3AB8AC7B11CCC435B42DCB4AED5",
"datasetName": "enhanced",
"enhancedOptions": {
"generalData": true,
"stakeholders": true,
"shareholders": false,
"beneficialOwners": false,
"suppressRefresh": false
},
"info": null,
"status": "COMPLETED",
"requestTime": "2025-04-02T09:39:14+00:00",
"responseTime": null,
"estimatedDeliverySeconds": 49,
"content": {
"kompanyId": "42C2B3AB8AC7B11CCC435B42DCB4AED5",
"countryCode": "DE",
"countryName": "Germany",
"state": null,
"registrationNumber": "HRB41217 MAINZ",
"name": "DATAGROUP Consulting Services GmbH",
"status": "LIVE",
"providedStatus": null,
"address": "Genfer Allee 2, 55129 Mainz",
"legalForm": "Gesellschaft mit beschränkter Haftung",
"additionalData": {
"otherIdentifiers": [
{
"identifierName": "localNumber",
"identifierValue": "HRB44217 MAINZ"
}
],
"contactInformation": {
"formattedAddress": {
"number": "2",
"street": "Genfer Allee",
"zip": "55129",
"city": "Mainz",
"extra": "55129 Mainz"
}
},
"shares": {
"shareCapitals": "1.020.000,00",
"shareCurrency": "EUR"
},
"legalEvents": {
"incorporationDate": "2012-09-27"
},
"registerCourt": "DE/MAINZ"
},
"associatedEntities": {
"shareholders": [],
"officers": [
{
"name": "Tobias Frank",
"role": "officer",
"providedRole": "Prokurist(in)",
"address": "Essenheim",
"dateOfBirth": "1968-05-31"
},
{
"name": "Steffen Harms",
"role": "officer",
"providedRole": "Prokurist(in)",
"address": "Oldenburg",
"dateOfBirth": "1960-07-22"
},
{
"name": "Karsten Rickhaus",
"role": "officer",
"providedRole": "Prokurist(in)",
"address": "Dalheim",
"dateOfBirth": "1970-01-18"
},
{
"name": "Michael Bierikoven-Bindarra",
"role": "officer",
"providedRole": "Prokurist(in)",
"address": "Bad Neuenahr-Ahrweiler",
"dateOfBirth": "1960-04-16"
},
{
"name": "Thomas Bünger",
"role": "officer",
"providedRole": "Prokurist(in)",
"address": "Hamburg",
"dateOfBirth": "1964-07-27"
},
{
"name": "Karsten Dauer",
"role": "officer",
"providedRole": "Prokurist(in)",
"address": "Brohl-Lützing",
"dateOfBirth": "1969-03-03"
},
{
"name": "Dennis Kennedy",
"role": "officer",
"providedRole": "Prokurist(in)",
"address": "Mainz",
"dateOfBirth": "1981-12-16"
},
{
"name": "Michael Heissler",
"role": "officer",
"providedRole": "Prokurist(in)",
"address": "Leonberg",
"dateOfBirth": "1977-05-08"
},
{
"name": "Helge Viehof",
"role": "managingDirector",
"providedRole": "Geschäftsführer",
"address": "Buchholz",
"dateOfBirth": "1966-04-06"
}
],
"ultimateBeneficialOwners": []
},
"industryActivityCode": null,
"providerSpecificData": {
"latestAccounts": {
"overdue": false
}
},
"sources": [
{
"name": "The Register Portal of the German Federal States (Handelsregister)",
"info": null,
"primary": true,
"fields": [
"$.additionalData.shares.shareCurrency",
"$.status",
"$.additionalData.legalEvents.incorporationDate",
"$.legalForm",
"$.registrationNumber",
"$.additionalData.otherIdentifiers[0]",
"$.additionalData.shares.shareCapitals",
"$.name",
"$.additionalData.contactInformation.formattedAddress",
"$.associatedEntities.officers"
],
"lastCheckedTime": "2016-06-22T19:44:02+00:00"
}
],
"version": "company-v2.0"
}
}
Response after for refresh dataset
{
"datasetId": "3007358AAD7E7CB757B6F3889134303F",
"kompanyId": "42C2B3AB8AC7B11CCC435B42DCB4AED5",
"datasetName": "refresh"
"info": null,
"status": "COMPLETED",
"requestTime": "2025-04-02T09:39:14+00:00",
"responseTime": null,
"estimatedDeliverySeconds": 49,
"content": {
"kompanyId": "42C2B3AB8AC7B11CCC435B42DCB4AED5",
"countryCode": "DE",
"countryName": "Germany",
"state": null,
"registrationNumber": "HRB41217 MAINZ",
"name": "DATAGROUP Consulting Services GmbH",
"status": "LIVE",
"providedStatus": "currently registered",
"address": "Genfer Allee 2, 55129 Mainz, Deutschland",
"legalForm": "Gesellschaft mit beschränkter Haftung",
"additionalData": {
"otherIdentifiers": [
{
"identifierName": "localNumber",
"identifierValue": "HRB44217 MAINZ"
}
],
"contactInformation": {
"formattedAddress": {
"number": "2",
"street": "Genfer Allee",
"zip": "55129",
"city": "Mainz",
"country": "Deutschland"
}
},
"shares": {
"shareCapitals": "1.020.000,00",
"shareCurrency": "EUR"
},
"legalEvents": {
"incorporationDate": "2012-09-27",
"registrationDate": "2012-09-30"
},
"registerCourt": "Registergericht Amtsgericht Mainz"
},
"associatedEntities": {
"shareholders": [
{
"name": "Alfred Keschtges",
"firstName":"Alfred",
"lastName":"Keschtges",
"role": "shareholder",
"providedRole": "Kommanditist(in)",
"isCorporate": false,
"address": "Lorch",
"shareCapitals": [
{
"numberOfShares": "20000"
},
"shareCurrency": "EUR"
],
} ,
{
"name": "KESNOWA GmbH",
"role": "shareholder",
"providedRole": "Persönlich haftende(r) Gesellschafter(in)",
"isCorporate": true,
"registrationNumber": "CHE-101.976.861",
"address": "Lorch",
"shareCapitals": [
{
"numberOfShares": "20000"
},
"shareCurrency": "EUR"
],
}
]
"officers": [
{
"name": "Tobias Frank",
"firstName":"Tobias",
"lastName":"Frank",
"role": "officer",
"providedRole": "Prokurist(in)",
"isCorporate": false,
"address": "Essenheim",
"dateOfBirth": "1968-05-31"
},
{
"name": "Steffen Harms",
"firstName":"Steffen",
"lastName":"Harms",
"role": "officer",
"providedRole": "Prokurist(in)",
"isCorporate": false,
"address": "Oldenburg",
"dateOfBirth": "1960-07-22"
},
{
"name": "Karsten Rickhaus",
"firstName":"Karsten",
"lastName":"Rickhaus"
"role": "officer",
"providedRole": "Prokurist(in)",
"isCorporate": false,
"address": "Dalheim",
"dateOfBirth": "1970-01-18"
}
],
"ultimateBeneficialOwners": []
},
"industryActivityCode": {
"activity": "Die Beratung von Unternehmen in betriebswirtschaftlichen, organisatorischen und informationstechnologischen Fragen, die Entwicklung und Anwendung von Softwareprodukten und die Vermarktung dieser Leistungen.",
"providerSpecificData": {
"latestAccounts": {
"overdue": false
},
"signatoryRights": "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten."
},
"sources": [
{
"name": "The Register Portal of the German Federal States (Handelsregister)",
"info": null,
"primary": true,
"fields": [
"$.additionalData.shares.shareCurrency",
"$.status",
"$.additionalData.legalEvents.incorporationDate",
"$.legalForm",
"$.registrationNumber",
"$.additionalData.otherIdentifiers[0]",
"$.additionalData.shares.shareCapitals",
"$.name",
"$.additionalData.contactInformation.formattedAddress",
"$.associatedEntities.officers"
],
"lastCheckedTime": "2016-06-22T19:44:02+00:00"
}
],
"version": "company-v2.0"
}
}
If you would like to provide us with feedback or you have a question related to this, don’t hesitate to contact us here: support team