Developer news
KYC API: Upcoming changes to our connection to the Taiwanese register
Posted 2025-10-22
Summary
We would like to inform you that we have implemented the following changes to our connection with the Administration of Commerce, Ministry of Economic Affairs of the Republic of China (中華民國經濟部) on KYC API.
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 register.
Data additions
We are pleased to share details of the update, 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.
Refresh dataset
- subclass / content.additionalData.subClass
- extraData.legalRepresentative / additionalData.legalRepresentative
- extradata.otherNumber / additionalData.otherIdentifiers.otherNumber
- extraData.dissolutionDate / additionalData.legalEvents.dissolutionDate
- extraData.registrationDate / additionalData.legalEvents.registrationDate
- extraData.registrationInstitution / additionalData.legalEvents.registrationInstitution
- people.officer.name / associatedEntities.officer.name
- people.officer.role / associatedEntities.officer.providedRole
- extraData.shareCapital / additionalData.shares.shareCapital
- extraData.paidupCapital / additional_data.shares.paidupCapital
- people.shareholder.name / associatedEntities.shareholder.name
- people.shareholder.shareNumber / associatedEntities.shareholder.numberOfShares
- people.shareholder.shareCapital / associatedEntities.shareholders.shareCapitals
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 applicable to both.Refresh dataset
- legalForm
- extraData.providedStatus / providedStatus
- sicNaceCodes / industryActivityCode.activityCodes
- extraData.legalRepresentative / additionalData.legalRepresentative
Data refinement
To ensure consistency with the data provided by the register, we will no longer display the incorporationDate for entities with the legalForm “partnership”, as this value is not supplied from the provider side. Other legalForms are not affected by this change, and the incorporationDate will continue to be available for them as before.
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": "F7A51391174AC6B5AAFC2B910527E88B",
"kompanyId": "647AF8EC4896F23394523D60C2130C84",
"datasetName": "refresh",
"datasetOptions": null,
"info": null,
"status": "COMPLETED",
"requestTime": "2025-07-14T07:40:23+00:00",
"responseTime": "2025-07-14T07:40:37+00:00",
"estimatedDeliverySeconds": 22,
"content": {
"kompanyId": "647AF8EC4896F23394523D60C2130C84",
"countryCode": "TW",
"countryName": "Taiwan",
"state": null,
"registrationNumber": "83388817",
"name": "萬泰鑫企業有限公司",
"status": "LIVE",
"providedStatus": "核准設立",
"address": "苗栗縣頭份市中興里育英街33巷1號1樓",
"legalForm": "Company",
"additionalData": {
"otherIdentifiers": [
{
"identifierName": "localNumber",
"identifierValue": "83388817"
}
],
"shares": {
"shareCapitals": "3000000"
},
"legalEvents": {
"incorporationDate": "2023-02-07",
"registrationInstitution": "經濟部中部辦公室"
}
},
"associatedEntities": {
"shareholders": [],
"officers": []
},
"industryActivityCode": null,
"providerSpecificData": {
"latestAccounts": {
"overdue": false
}
},
"sources": [
{
"name": "Ministry of Economic Affairs - Department of Commerce (經濟部商業司)",
"info": null,
"primary": true,
"fields": [
"$.status",
"$.additionalData.legalEvents.incorporationDate",
"$.legalForm",
"$.additionalData.legalEvents.registrationInstitution",
"$.registrationNumber",
"$.additionalData.otherIdentifiers[0]",
"$.additionalData.shares.shareCapitals",
"$.providedStatus",
"$.name",
"$.address"
],
"lastCheckedTime": "2025-07-14T07:40:37+00:00"
}
],
"version": "company-v2.0"
}
}
Response after for refresh dataset
{
"datasetId": "F7A51391174AC6B5AAFC2B910527E88B",
"kompanyId": "647AF8EC4896F23394523D60C2130C84",
"datasetName": "refresh",
"datasetOptions": null,
"info": null,
"status": "COMPLETED",
"requestTime": "2025-07-14T07:40:23+00:00",
"responseTime": "2025-07-14T07:40:37+00:00",
"estimatedDeliverySeconds": 22,
"content": {
"kompanyId": "647AF8EC4896F23394523D60C2130C84",
"countryCode": "TW",
"countryName": "Taiwan",
"state": null,
"registrationNumber": "83388817",
"name": "萬泰鑫企業有限公司",
"status": "LIVE",
"providedStatus": "核准設立",
"address": "苗栗縣頭份市中興里育英街33巷1號1樓",
"legalForm": "公司",
"additionalData": {
"otherIdentifiers": [
{
"identifierName": "localNumber",
"identifierValue": "83388817"
}
],
"shares": {
"shareCapitals": "5000000",
"paidUpCapital": "5000000"
},
"legalEvents": {
"incorporationDate": "2023-02-07",
"registrationInstitution": "經濟部中部辦公室",
},
"legalRepresentative": "張展圖"
},
"associatedEntities": {
"shareholders": [
{
"name": "王雪紅",
"role": "shareholder",
"providedRole": "董事長",
"shareCapitals": [
{
"numberOfShares": "32272427"
}
],
},
{
"name": "陳文琦",
"role": "shareholder",
"providedRole": "董事",
"shareCapitals": [
{
"numberOfShares": "22391389"
}
],
}
],
"officers": [
{
"name": "王雪紅",
"role": "officer",
"providedRole": "董事長"
},
{
"name": "陳文琦",
"role": "officer",
"providedRole": "董事"
},
{
"name": "David Bruce Yoffie",
"role": "officer",
"providedRole": "董事"
},
{
"name": "蔡純清Vincent Thai",
"role": "officer",
"providedRole": "獨立董事"
},
]
},
"industryActivityCode": {
"activityCodes": [
"CC01080 - 電子零組件製造業",
"CC01100 - 電信管制射頻器材製造業"
]
}
"providerSpecificData": {
"latestAccounts": {
"overdue": false
}
},
"sources": [
{
"name": "Ministry of Economic Affairs - Department of Commerce (經濟部商業司)",
"info": null,
"primary": true,
"fields": [
"$.status",
...
],
"lastCheckedTime": "2025-07-14T07:40:37+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