Developer news
KYC API: Upcoming changes to our connection to the Indian register
Summary
Data improvements
We are pleased to share details of the upcoming updates, which include the introduction of a new super dataset, the addition of new fields in the refresh dataset, enhancements to existing fields and increased stability of the connection with the registry.
More specifically, the new India super dataset will enable you to access a complete company profile, including core registration details, capital and listing information, and most importantly officers data.
Super dataset
The super dataset available in KYC API v2 contains the following fields.
New fields
- content.status
- content.providedStatus
- content.address
- content.legalForm
- content.additionalData.otherIdentifiers.identifierName
- content.additionalData.otherIdentifiers.identifierValue
- content.additionalData.contactInformation.email
- content.additionalData.shares.shareCapitals
- content.additionalData.legalEvents.incorporationDate
- content.additionalData.legalEvents.registrationInstitution
- content.additionalData.listed
- content.associatedEntities.officers.name
- content.associatedEntities.officers.role
- content.associatedEntities.officers.providedRole
- content.associatedEntities.officers.startDate
- content.associatedEntities.officers.personalId
- content.associatedEntities.officers.additionalAssociatedEntityData.signatoryRights
- content.industryActivityCode
- content.providerSpecificData.latestAccounts.lastMadeUpDate
Refresh dataset
As part of our ongoing improvements, we are introducing newly added and enhanced data fields that provide greater detail and accuracy. These enhancements are tailored to specific legal forms, meaning that availability and visibility may vary depending on the legal form of the entity. This ensures that the data presented aligns closely with what is provided by the registers. The first field applies to KYC API v1, whereas the second field is relevant to KYC API v2.
New fields
- latestAccounts.lastMadeUpDate / content.providerSpecificData.latestAccounts.lastMadeUpDate
- extraData.registrationDate / content.additionalData.legalEvents.registrationDate
- extraData.listed / content.additionalData.listed
- extraData.registrationInstitution / content.additionalData.legalEvents.registrationInstitution
- extraData.shareCapital / content.additionalData.shares.shareCapitals
- extraData.paidUpCapital / content.additionalData.shares.paidUpCapital
Enriched fields
- address / content.address
- legalForm / content.legalForm
Data refinement
Updates on officers
To enhance our data quality, uphold product integrity, and improve the user experience, we are implementing the following modifications to the officers displayed for the Indian register. We will introduce the fields officer.name, officer.role and officer.startDate in the super dataset on KYC API v2 and remove them from refresh. The following fields will be moved from refresh to super dataset KYC API v1 and KYC API v2:- people.officer.name / associatedEntities.officer.name
- people.officer.role / associatedEntities.officer.providedRole
- people.officer.startDate / associatedEntities.officer.startDate
Updates on shares’ authorized capital
To improve the user experience, we have renamed the shares.authorizedCapital field to shares.shareCapitals on KYC API v2 as this better reflects the data it represents. In line with this change, the content.providerSpecificData.authorizedCapital field will be excluded entirely from KYC API v2 to ensure consistency and clarity in data handling, since this information will be available under shares.shareCapitals.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 the various legal forms.
Response for refresh dataset
{
"datasetId": "77CFB7ED1F422986BF3CE2B2898E400D",
"kompanyId": "026A90FB3B4105EC941F52A16B4B5164",
"datasetName": "refresh",
"datasetOptions": null,
"info": null,
"status": "COMPLETED",
"requestTime": "2025-07-16T19:08:51+00:00",
"responseTime": "2025-07-16T19:08:53+00:00",
"estimatedDeliverySeconds": 20,
"content": {
"kompanyId": "026A90FB3B4105EC941F52A16B4B5164",
"countryCode": "IN",
"countryName": "India",
"state": null,
"registrationNumber": "F069**",
"name": "Health International ***",
"status": "LIVE",
"providedStatus": "Active",
"address": "4th Floor, Imperial Amity, Chalikkavattam, NH66, Bypass, Vyttila Ernakulam Ernakulam KL 682019 IN",
"legalForm": "Foreign Company",
"additionalData": {
"otherIdentifiers": [
{
"identifierName": "localNumber",
"identifierValue": "F069**"
}
],
"contactInformation": {
"email": "governance@hki.edu.au"
},
"shares": {
"paidUpCapital": "100000",
"authorizedCapital": "100000"
},
"legalEvents": {
"incorporationDate": "2024-07-10",
"registrationInstitution": "ROC Bangalore"
},
"listed": "N"
},
"associatedEntities": {
"shareholders": [],
"officers": []
},
"industryActivityCode": {
"activity": "Community, personal & Social Services"
},
"providerSpecificData": {
"latestAccounts": {
"lastMadeUpDate": "2024-03-31",
"overdue": false
}
},
"sources": [
{
"name": "Ministry of Corporate Affairs",
"info": null,
"primary": true,
"fields": [
"$.status",
"$.additionalData.legalEvents.incorporationDate",
"$.legalForm",
"$.registrationNumber",
"$.additionalData.otherIdentifiers[0]",
"$.additionalData.contactInformation.email",
"$.providedStatus",
"$.name",
"$.associatedEntities.officers",
"$.address"
],
"lastCheckedTime": "2025-07-16T19:08:53+00:00"
}
],
"version": "company-v2.0"
}
}
Response for super dataset
{
"datasetId": "C3361FB75FDD34DF812086F5B1E6A369",
"kompanyId": "9FA42E874A857DC488DEF2EDD5777754",
"datasetName": "super",
"datasetOptions": null,
"info": null,
"status": "COMPLETED",
"requestTime": "2025-07-16T18:24:44+00:00",
"responseTime": "2025-07-16T18:24:46+00:00",
"estimatedDeliverySeconds": 20,
"content": {
"kompanyId": "9FA42E874A857DC488DEF2EDD5777754",
"countryCode": "IN",
"countryName": "India",
"state": null,
"registrationNumber": "U45206KA2013PTC07*****",
"name": "SAM GYPSUM **** LIMITED",
"status": "LIVE",
"providedStatus": "Active",
"address": "NO.111, Ground Floor, Mysugar Building J.C.ROAD NA BENGALORE Bangalore KA 560002 IN",
"legalForm": "Company limited by Shares (Non-govt company)",
"additionalData": {
"otherIdentifiers": [
{
"identifierName": "localNumber",
"identifierValue": "U45206KA2013PTC07*****"
}
],
"contactInformation": {
"email": "ismail@sam**psum.com"
},
"shares": {
"paidUpCapital": "4992740",
"authorizedCapital": "8000000"
},
"legalEvents": {
"incorporationDate": "2013-12-20",
"registrationInstitution": "ROC Bangalore"
},
"listed": "N"
},
"associatedEntities": {
"shareholders": [],
"officers": [
{
"name": "THANZIL AHMED ISHRATHULLA",
"role": "officer",
"providedRole": "Director - Promoter",
"startDate": "2013-12-20",
"personalId": "06*****",
"additionalAssociatedEntityData": {
"signatoryRights": "Yes"
}
},
{
"name": "IMRAN FAROOQI",
"role": "officer",
"providedRole": "Director - Promoter",
"startDate": "2013-12-20",
"personalId": "06*****",
"additionalAssociatedEntityData": {
"signatoryRights": "Yes"
}
}
]
},
"industryActivityCode": {
"activity": "Construction"
},
"providerSpecificData": {
"authorizedCapital": "8000000",
"latestAccounts": {
"lastMadeUpDate": "2024-03-31",
"overdue": false
}
},
"sources": [
{
"name": "Ministry of Corporate Affairs",
"info": null,
"primary": true,
"fields": [
***
],
"lastCheckedTime": "2025-07-16T18:24:45+00:00"
},
{
"name": "Global Legal Entity Identifier Foundation",
"info": null,
"primary": false,
"fields": [],
"lastCheckedTime": "2025-07-16T18:24:46+00:00"
}
],
"version": "company-v2.0"
}
}