Developer news
KYC API: Upcoming changes to our connection to the Slovakian register
Posted 2025-07-21
|
Updated 2025-08-12
Summary
We would like to inform you that we have scheduled the implementation of the following changes to our connection with The Statistical Office of the Slovak Republic on KYC API, available with the 3rd of September 2025’s release.
Enhanced search
We are pleased to announce the enhancement of the existing name search functionality with the introduction of number-based search capabilities. This new feature will be available for all legal entity types registered with The Statistical Office of the Slovak Republic via the KYC API.
Data additions
We are pleased to share details of the upcoming updates, including the addition of new fields within the refresh dataset. The first field applies to KYC API v1, whereas the second field is relevant to KYC API v2. If only one field is presented, it is only applicable to KYC API v2.
Refresh dataset
- extraData.registerCourt / additionalData.registerCourt
- signatoryRights / providerSpecificData.signatoryRights
- extraData.shareType / additionalData.shares.shareType
- extradaData.sharePrice / additionalData.shares.sharePrice
- extradaData.shareNumber / additionalData.shares.numberOfShares
- extraData.registrationDate / additionalData.legalEvents.registrationDate
- formattedAddress.street / additionalData.contactInformation.formattedAddress.street
- formattedAddress.number / additionalData.contactInformation.formattedAddress.number
- formattedAddress.zip / additionalData.contactInformation.formattedAddress.zip
- formattedAddress.city / additionalData.contactInformation.formattedAddress.city
- formattedAddress.country / additionalData.contactInformation.formattedAddress.country
- people.shareholder.registrationNumber / associatedEntities.shareholder.registrationNumber
- people.officer.startDate / associatedEntities.officer.startDate
- associatedEntities.shareholder.firstName
- associatedEntities.shareholder.lastName
- associatedEntities.officer.firstName
- associatedEntities.officer.lastName
Data enhancements
In addition to the new fields, we are also enhancing the following fields within the refresh dataset. As above, the first field applies to KYC API v1, whereas the second field is relevant to KYC API v2. If only one field is presented, it is only applicable to KYC API v2.Refresh dataset
- extraData.shareCapital / additionalData.shares.shareCapital
- extraData.shareCurrency / additionalData.shares.shareCurrency
- extraData.paidupCapital / additionalData.shares.paidupCapital
- people.officer.role / associatedEntities.officer.providedRole
- people.officer.name / content.associatedEntities.officers.name
- people.shareholder.name / content.associatedEntities.shareholder.name
- people.officer.isCorporate / content.associatedEntities.officers.isCorporate
- people.shareholder.isCorporate / content.associatedEntities.shareholder.isCorporate
Data refinement
To improve data accuracy, we have decided to utilize registrationDate as field name instead of incorporationDate for Slovakia as it more accurately reflects the mapped value. To minimize disruption for clients using KYC API v1, we will continue to display the incorporationDate with the value of registrationDate in KYC API v1. Furthermore, to maintain product integrity, the incorporationDate will be removed from KYC API v2 moving forward.
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": "E7C41C0A591746590159C21516C4570D",
"kompanyId": "998F54388E0D9DD00906FF17ADC23BD8",
"datasetName": "refresh",
"datasetOptions": null,
"info": null,
"status": "COMPLETED",
"requestTime": "2025-07-14T09:53:34+00:00",
"responseTime": "2025-07-14T09:53:35+00:00",
"estimatedDeliverySeconds": 20,
"content": {
"kompanyId": "998F54388E0D9DD00906FF17ADC23BD8",
"countryCode": "SK",
"countryName": "Slovakia",
"state": null,
"registrationNumber": "500525xx",
"name": "Slovenská pôda xx.",
"status": "LIVE",
"providedStatus": null,
"address": "Jégého, 16999/8, 82108, Bratislava - mestská časť Ružinov, Slovenská republika",
"legalForm": "Komanditná spoločnosť",
"additionalData": {
"otherIdentifiers": [
{
"identifierName": "localNumber",
"identifierValue": "500525xx"
}
],
"shares": {
"shareCapitals": "6842785.60",
"paidUpCapital": "6 842 785,60",
"shareCurrency": "EUR"
},
"legalEvents": {
"incorporationDate": "2016-01-26"
}
},
"associatedEntities": {
"shareholders": [
{
"name": "Dr. Karl Stiefsohn",
"role": "shareholder",
"providedRole": "Komplementár",
"address": "Hauptstraße, 33, 3143, Pyhra, Rakúska republika"
},
{
"name": "Dr. Elisabeth Stiefsohn",
"role": "shareholder",
"providedRole": "Komanditista",
"address": "Hauptstraße, 33, 3143, Pyhra, Rakúska republika",
"sharePercentage": 100,
"shareCapitals": [
{
"numberOfShares": "250.0"
}
],
"shareCurrency": "EUR"
}
],
"officers": [
{
"name": "Dr. Karl Stiefsohn",
"role": "officer",
"providedRole": "Komplementár",
"address": "Hauptstraße, 33, 3143, Pyhra, Rakúska republika"
}
]
},
"industryActivityCode": {
"activityCodes": [
"01110 - Pestovanie obilnín (okrem ryže), strukovín a olejnatých semien",
"11003 - Nefinančné korporácie pod zahraničnou kontrolou"
],
"activity": "Činnosť podnikateľských, organizačných a ekonomických poradcov, Kúpa tovaru na účely jeho predaja konečnému spotrebiteľovi (maloobchod) alebo iným prevádzkovateľom živnosti (veľkoobchod), Sprostredkovateľská činnosť v oblasti služieb, Sprostredkovateľská činnosť v oblasti výroby, Poľnohospodárstvo a lesníctvo včítane predaja nespracovaných poľnohospodárskych a lesných výrobkov za účelom spracovania alebo ďalšieho predaja"
},
"providerSpecificData": {
"latestAccounts": {
"overdue": false
}
},
"sources": [
{
"name": "Business Register of the Slovak Republic (Obchodný Register Slovenskej Republiky)",
"info": null,
"primary": true,
"fields": [
"$.registrationNumber",
"$.additionalData.otherIdentifiers[0]",
"$.additionalData.shares.shareCapitals",
"$.name",
"$.additionalData.shares.shareCurrency",
"$.status",
"$.additionalData.legalEvents.incorporationDate",
"$.legalForm",
"$.additionalData.shares.paidUpCapital",
"$.industryActivityCode.activityCodes",
"$.industryActivityCode.activity",
"$.associatedEntities.officers",
"$.associatedEntities.shareholders",
"$.address"
],
"lastCheckedTime": "2025-07-14T09:53:35+00:00"
}
],
"version": "company-v2.0"
}
}
Response after for refresh dataset
{
"datasetId": "36E60867DF515D08ECBEF2F01FA25BAB",
"kompanyId": "BBBB809A8904A395939BB0F18650C91C",
"datasetName": "refresh",
"datasetOptions": null,
"info": null,
"status": "COMPLETED",
"requestTime": "2025-07-14T10:59:00+00:00",
"responseTime": "2025-07-14T10:59:02+00:00",
"estimatedDeliverySeconds": 28,
"content": {
"kompanyId": "BBBB809A8904A395939BB0F18650C91C",
"countryCode": "SK",
"countryName": "Slovakia",
"state": null,
"registrationNumber": "500525xx",
"name": "Slovenská pôda xx.",
"status": "LIVE",
"providedStatus": null,
"address": "Jégého, 16999/8, 82108, Bratislava - mestská časť Ružinov, Slovenská republika",
"legalForm": "Komanditná spoločnosť",
"additionalData": {
"otherIdentifiers": [
{
"identifierName": "localNumber",
"identifierValue": "500525xx"
}
],
"contactInformation": {
"formattedAddress": {
"number": "16999/8",
"street": "Jégého",
"zip": "82108",
"city": "Bratislava - mestská časť Ružinov",
"country": "Slovenská republika"
}
},
"shares": {
"numberOfShares": 206,
"shareCapitals": "6842785.60",
"shareType": "Kmeňová akcia",
"sharePrice": 33,
"paidUpCapital": "6 842 785,60",
"shareCurrency": "EUR"
},
"legalEvents": {
"registrationDate": "2016-01-26"
},
"registerCourt": "Mestský súd Bratislava III"
},
"associatedEntities": {
"shareholders": [
{
"name": "Dr. Karl Stiefsohn",
"firstName": "Karl",
"lastName": "Stiefsohn",
"role": "shareholder",
"providedRole": "Komplementár",
"isCorporate": false,
"address": "Hauptstraße, 33, 3143, Pyhra, Rakúska republika",
"startDate": "2022-10-21"
},
{
"name": "Dr. Elisabeth Stiefsohn",
"firstName": "Elisabeth",
"lastName": "Stiefsohn",
"role": "shareholder",
"providedRole": "Komanditista",
"isCorporate": false,
"address": "Hauptstraße, 33, 3143, Pyhra, Rakúska republika",
"startDate": "2022-10-21"
}
],
"officers": [
{
"name": "Dr. Karl Stiefsohn",
"firstName": "Karl",
"lastName": "Stiefsohn",
"role": "officer",
"providedRole": "Komplementár",
"isCorporate": false,
"address": "Hauptstraße, 33, 3143, Pyhra, Rakúska republika",
"startDate": "2016-01-26"
},
{
"name": "XINTERTECH Atlantics xxx",
"role": "officer",
"providedRole": "Spoločník",
"isCorporate": true,
"address": "1309 Coffeen Avenue STE, 1200, 82801, Sheridan, Wyoming, Spojené štáty americké",
"startDate": "2024-04-06"
},
]
},
"industryActivityCode": {
"activityCodes": [
"01110 - Pestovanie obilnín (okrem ryže), strukovín a olejnatých semien",
"11003 - Nefinančné korporácie pod zahraničnou kontrolou"
],
"activity": "Činnosť podnikateľských, organizačných a ekonomických poradcov, Kúpa tovaru na účely jeho predaja konečnému spotrebiteľovi (maloobchod) alebo iným prevádzkovateľom živnosti (veľkoobchod), Sprostredkovateľská činnosť v oblasti služieb, Sprostredkovateľská činnosť v oblasti výroby, Poľnohospodárstvo a lesníctvo včítane predaja nespracovaných poľnohospodárskych a lesných výrobkov za účelom spracovania alebo ďalšieho predaja"
},
"providerSpecificData": {
"latestAccounts": {
"overdue": false
},
"signatoryRights": "Každý komplementár je oprávnený konať za spoločnosť samostatne."
},
"sources": [
{
"name": "Ministry of Justice",
"info": null,
"primary": true,
"fields": [
"$.providerSpecificData.signatoryRights",
"$.registrationNumber",
"$.additionalData.otherIdentifiers[0]",
"$.additionalData.shares.shareCapitals",
"$.name",
"$.additionalData.shares.shareCurrency",
"$.status",
"$.legalForm",
"$.additionalData.shares.paidUpCapital",
"$.industryActivityCode.activityCodes",
"$.additionalData.legalEvents.registrationDate",
"$.industryActivityCode.activity",
"$.associatedEntities.officers",
"$.associatedEntities.shareholders",
"$.additionalData.contactInformation.formattedAddress"
],
"lastCheckedTime": "2025-07-14T10:59:01+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