Developer news
KYC API: Upcoming changes to our connection to the Chinese register
Posted 2025-06-21
|
Updated 2025-06-23
Summary
We would like to inform you that we have scheduled the implementation of the following changes to our connection with the The National Enterprise Credit Information Publicity System (NECI) on KYC API, available with the 9th of July 2025’s release.
Additional data
We are pleased to share details of the upcoming updates, including the addition of new fields within the refresh and super 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.otherNumber / additionalData.otherIdentifiers.otherNumber
- extradata.registrationInstitution / additionalData.legalEvents.registrationInstitution
- additionalData.otherNames.translatedName
Super dataset
- extradata.otherNumber / additionalData.otherIdentifiers.otherNumber
- extradata.registrationInstitution / additionalData.legalEvents.registrationInstitution
- extraData.dateOfLicense / providerSpecificData.dateOfLicense
- extradata.numberOfEmployees / additionalData.numberOfEmployees
- extradata.listed / additionalData.listed
- people.shareholder.registrationNumber / associatedEntities.shareholder.registrationNumber
- people.shareholder.translatedName / associatedEntities.shareholder.translatedName
- extraData.shareType / additionalData.shares.shareType
- additionalData.branches.name
- additionalData.branches.number
- additionalData.branches.registrationInstitution
- additionalData.otherNames.translatedName
- associatedEntities.shareholder.residenceCountry
- associatedEntities.shareholder.providedRole
- associatedEntities.officer.translatedName
Data refinement
Updated identifiers
To enhance our data quality, uphold product integrity, and improve the user experience, we are implementing the following modifications to the identifiers for the Chinese register. We will move the identifier oldNumber under the existing otherNumber. Additionally, all instances of oldNumber will be removed from refresh and super dataset on KYC API v1 and KYC API v2. Kindly review the impacted fields: extradata.oldNumber / additionalData.otherIdentifiers.oldNumber
Adjustment of otherNames
To improve data accuracy, we have decided to utilize otherNames to more accurately reflect the mapped values as follows: Under otherNames will from now on be shown englishNames and translatedNames, according to the values provided from the source. Therefore, to maintain product integrity, the otherNames field will be removed from refresh and super dataset on KYC API v1 and KYC API v2. Kindly review the impacted fields: extradata.otherName / additionalData.otherNames.otherNames
Exchanging registerCourt
Aligned with this approach, the registerCourt field will be excluded entirely from the super dataset on KYC API v1 and KYC API v2 to ensure consistency and clarity in data handling. Moving forward, we will use the registrationInstitution field to deliver this information. This feature is now included in this release for your convenience. Kindly review the impacted fields: extraData.registerCourt / additionalData.registerCourt
Conforming shareholderCurrency
Furthermore, to ensure consistency and clarity in data representation, the field shareholderCurrency will no longer appear within the shareholder section of the super dataset on KYC API v1 and KYC API v2. Instead, this information will now be provided exclusively within the shares section. Kindly review the impacted fields: people.shareholder.shareCurrency / associatedEntities.shareholder.shareCurrency
The full list of all removed fields within the refresh and super dataset is stated below. The first field applies to KYC API v1, whereas the second field is relevant to KYC API v2:
- extradata.oldNumber / additionalData.otherIdentifiers.oldNumber
- extraData.registerCourt / additionalData.registerCourt
- people.shareholder.shareCurrency / associatedEntities.shareholder.shareCurrency
- extradata.otherName / additionalData.otherNames.otherNames
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": "2CE35138C54D1E214C5BED7A1B5B0D16",
"kompanyId": "381F978B960A5F101A9592CEF7251F66",
"datasetName": "refresh",
"datasetOptions": null,
"info": null,
"status": "COMPLETED",
"requestTime": "2025-06-23T07:28:19+00:00",
"responseTime": "2025-06-23T07:28:20+00:00",
"estimatedDeliverySeconds": 20,
"content": {
"kompanyId": "381F978B960A5F101A9592CEF7251F66",
"countryCode": "CN",
"countryName": "China",
"state": null,
"registrationNumber": "911101085513851282Q",
"name": "小米科技有限责任公司",
"status": "LIVE",
"providedStatus": "In Business",
"address": "北京市海淀区西二旗中路33号院6号楼6层006号",
"additionalData": {
"otherIdentifiers": [
{
"identifierName": "oldNumber",
"identifierValue": "110108012660422"
},
{
"identifierName": "localNumber",
"identifierValue": "911101085513851282Q"
}
],
"otherNames": {
"englishNames": [
"Beijing Xiaomi Technology ***"
]
},
"legalEvents": {
"incorporationDate": "2010-03-03"
},
"legalRepresentative": "Lei Jun"
},
"associatedEntities": {
"shareholders": [],
"officers": []
},
"industryActivityCode": null,
"providerSpecificData": {
"latestAccounts": {
"overdue": false
}
},
"sources": [
{
"name": "State Administration for Market Regulation (国家市场监督管理总局)",
"info": null,
"primary": true,
"fields": [
"$.status",
"$.additionalData.legalEvents.incorporationDate",
"$.additionalData.otherIdentifiers[0]",
"$.registrationNumber",
"$.additionalData.otherIdentifiers[1]",
"$.additionalData.otherNames.englishNames",
"$.additionalData.legalRepresentative",
"$.providedStatus",
"$.name"
],
"lastCheckedTime": "2025-06-23T07:28:20+00:00"
}
],
"version": "company-v2.0"
}
}
Response after for refresh dataset
{
"datasetId": "4FA50FB0A1D709EF1BC56CF127C64741",
"kompanyId": "381F978B960A5F101A9592CEF7251F66",
"datasetName": "refresh",
"datasetOptions": null,
"info": null,
"status": "COMPLETED",
"requestTime": "2025-03-03T16:20:26+00:00",
"responseTime": "2025-03-03T16:20:29+00:00",
"estimatedDeliverySeconds": 23,
"content": {
"kompanyId": "381F978B960A5F101A9592CEF7251F66",
"countryCode": "CN",
"countryName": "China",
"state": null,
"registrationNumber": "91110108551385082Q",
"name": "小米科技有限责任公司",
"status": "LIVE",
"providedStatus": "在营",
"address": "北京市海淀区西二旗中路33号院6号楼6层006号",
"additionalData": {
"otherIdentifiers": [
{
"identifierName": "otherNumber",
"identifierValue": "110108012660422"
},
{
"identifierName": "localNumber",
"identifierValue": "91110108551385082Q"
}
],
"shares": {
"shareCapitals": "185000.0"
},
"otherNames": {
"englishNames": [
"Beijing Xiaomi Technology ***"
]
},
"legalEvents": {
"incorporationDate": "2010-03-03"
},
"legalRepresentative": "雷军"
},
"associatedEntities": {
"shareholders": [],
"officers": []
},
"industryActivityCode": null,
"providerSpecificData": {
"latestAccounts": {
"overdue": false
}
},
"sources": [
{
"name": "State Administration for Market Regulation (国家市场监督管理总局)",
"info": null,
"primary": true,
"fields": [
"$.status",
"$.additionalData.legalEvents.incorporationDate",
"$.additionalData.otherIdentifiers[0]",
"$.registrationNumber",
"$.additionalData.otherIdentifiers[1]",
"$.additionalData.otherNames.englishNames",
"$.additionalData.legalRepresentative",
"$.providedStatus",
"$.name"
],
"lastCheckedTime": "2025-03-03T16:20:29+00:00"
}
],
"version": "company-v2.0"
}
}
Response before for super dataset
{
"datasetId": "F2F5B45CA5A617A96ACE24E03F5BF00B",
"kompanyId": "381F978B960A5F101A9592CEF7251F66",
"datasetName": "super",
"datasetOptions": null,
"info": null,
"status": "COMPLETED",
"requestTime": "2025-06-23T07:29:10+00:00",
"responseTime": "2025-06-23T07:29:14+00:00",
"estimatedDeliverySeconds": 46,
"content": {
"kompanyId": "381F978B960A5F101A9592CEF7251F66",
"countryCode": "CN",
"countryName": "China",
"state": null,
"registrationNumber": "911101085513854082Q",
"name": "小米科技有限责任公司",
"status": "LIVE",
"providedStatus": "存续(在营、开业、在册)",
"address": "北京市海淀区西二旗中路33号院6号楼6层006号",
"legalForm": "有限责任公司(自然人投资或控股)",
"additionalData": {
"otherIdentifiers": [
{
"identifierName": "oldNumber",
"identifierValue": "110106012660422"
},
{
"identifierName": "localNumber",
"identifierValue": "911101085513854082Q"
},
{
"identifierName": "otherNumber",
"identifierValue": "55138508-2"
}
],
"otherNames": {
"otherNames": [
"北京小米科技有限责任公司"
],
"englishNames": [
"Beijing Xiaomi Technology ****"
]
},
"contactInformation": {
"website": "https://www.mi.com",
"email": "[email protected]",
"phone": [
"010-69630728"
]
},
"shares": {
"shareCapitals": "1850000000.00",
"shareCurrency": "人民币"
},
"legalEvents": {
"incorporationDate": "2010-03-03"
},
"registerCourt": "北京市海淀区市场监督管理局",
"legalRepresentative": "雷军"
},
"associatedEntities": {
"shareholders": [
{
"name": "雷军",
"role": "shareholder",
"sharePercentage": 77.8,
"shareCapitals": [
{
"numberOfShares": "1439340478.00"
}
],
"shareCurrency": "人民币"
},
{
"name": "黎万强",
"role": "shareholder",
"sharePercentage": 10.12,
"shareCapitals": [
{
"numberOfShares": "187243569.00"
}
],
"shareCurrency": "人民币"
},
{
"name": "洪锋",
"role": "shareholder",
"sharePercentage": 10.07,
"shareCapitals": [
{
"numberOfShares": "186230990.00"
}
],
"shareCurrency": "人民币"
},
{
"name": "刘德",
"role": "shareholder",
"sharePercentage": 2.01,
"shareCapitals": [
{
"numberOfShares": "37184963.00"
}
],
"shareCurrency": "人民币"
}
],
"officers": [
{
"name": "卢伟冰",
"role": "officer",
"providedRole": "董事"
},
{
"name": "刘德",
"role": "officer",
"providedRole": "监事"
},
{
"name": "孙谦",
"role": "officer",
"providedRole": "财务负责人"
},
{
"name": "雷军",
"role": "officer",
"providedRole": "董事长,经理"
},
{
"name": "林斌",
"role": "officer",
"providedRole": "董事"
}
],
"ultimateBeneficialOwners": []
},
"industryActivityCode": {
"activity": "一般项目：技术服务、技术开发、技术咨询、技术交流、技术转让、技术推广；货物进出口；技术进出口；进出口代理；通讯设备销售；厨具卫具及日用杂品批发；厨具卫具及日用杂品零售；个人卫生用品销售；卫生用品和一次性使用医疗用品销售；日用杂品销售；日用百货销售；日用品销售；化妆品批发；化妆品零售；第一类医疗器械销售；第二类医疗器械销售；玩具销售；体育用品及器材零售；体育用品及器材批发；文具用品零售；文具用品批发；鞋帽批发；鞋帽零售；服装服饰批发；服装服饰零售；钟表销售；眼镜销售（不含隐形眼镜）；针纺织品销售；, 家用电器销售；日用家电零售；家具销售；礼品花卉销售；农作物种子经营（仅限不再分装的包装种子）；照相机及器材销售；照相器材及望远镜批发；照相器材及望远镜零售；工艺美术品及收藏品零售（象牙及其制品除外）；工艺美术品及礼仪用品销售（象牙及其制品除外）；计算机软硬件及辅助设备零售；计算机软硬件及辅助设备批发；珠宝首饰零售；珠宝首饰批发；食用农产品批发；食用农产品零售；宠物食品及用品批发；宠物食品及用品零售；电子产品销售；摩托车及零配件零售；摩托车及零配件批发；电动自行车销售；助动自行车、代步车及零配件销, 售；自行车及零配件零售；自行车及零配件批发；单用途商业预付卡代理销售；商用密码产品销售；五金产品批发；五金产品零售；建筑材料销售；仪器仪表修理；计算机及办公设备维修；办公设备销售；会议及展览服务；组织文化艺术交流活动；广告设计、代理；广告制作；广告发布；摄影扩印服务；票务代理服务；通讯设备修理；移动终端设备制造；可穿戴智能设备制造。（除依法须经批准的项目外，凭营业执照依法自主开展经营活动）许可项目：第三类医疗器械经营；网络文化经营；出版物零售；出版物批发；食品销售；药品零售；广播电视节目制作经营, ；第一类增值电信业务；第二类增值电信业务；在线数据处理与交易处理业务（经营类电子商务）；基础电信业务；互联网信息服务；信息网络传播视听节目。（依法须经批准的项目，经相关部门批准后方可开展经营活动，具体经营项目以相关部门批准文件或许可证件为准）（不得从事国家和本市产业政策禁止和限制类项目的经营活动。）"
},
"providerSpecificData": {
"latestAccounts": {
"overdue": false
}
},
"sources": [
{
"name": "State Administration for Market Regulation (国家市场监督管理总局)",
"info": null,
"primary": true,
"fields": [
"$.additionalData.otherIdentifiers[0]",
"$.additionalData.contactInformation.phone",
"$.registrationNumber",
"$.additionalData.otherIdentifiers[1]",
"$.additionalData.shares.shareCapitals",
"$.additionalData.otherIdentifiers[2]",
"$.additionalData.otherNames.englishNames",
"$.additionalData.contactInformation.email",
"$.providedStatus",
"$.additionalData.legalRepresentative",
"$.name",
"$.additionalData.shares.shareCurrency",
"$.status",
"$.additionalData.legalEvents.incorporationDate",
"$.legalForm",
"$.additionalData.otherNames.otherNames",
"$.additionalData.contactInformation.website",
"$.industryActivityCode.activity",
"$.associatedEntities.officers",
"$.associatedEntities.shareholders",
"$.address"
],
"lastCheckedTime": "2024-12-19T08:38:00+00:00"
}
],
"version": "company-v2.0"
}
}
Response after for super dataset
{
"datasetId": "5FFB7B497A2D7A0D087EE841B563EE33",
"kompanyId": "381F978B960A5F101A9592CEF7251F66",
"datasetName": "super",
"info": null,
"status": "COMPLETED",
"requestTime": "2025-03-03T16:33:42+00:00",
"responseTime": null,
"estimatedDeliverySeconds": 26,
"content": {
"kompanyId": "381F978B960A5F101A9592CEF7251F66",
"countryCode": "CN",
"countryName": "China",
"state": null,
"registrationNumber": "911101085513854082Q",
"name": "小米科技有限责任公司",
"status": "LIVE",
"providedStatus": "在营（开业）",
"address": "北京市海淀区西二旗中路33号院6号楼6层006号",
"legalForm": "有限责任公司(自然人投资或控股)",
"additionalData": {
"otherIdentifiers": [
{
"identifierName": "oldNumber",
"identifierValue": "110106012660422"
},
{
"identifierName": "localNumber",
"identifierValue": "911101085513854082Q"
},
{
"identifierName": "otherNumber",
"identifierValue": "55138308-2"
}
],
"branches": [
{
"name": "小米科技有限责任公司保定莲池分公司",
"number": "91130606MA7J5PBW4X",
"registrationInstitution": "莲池区市场监督管理局"
},
{
"name": "小米科技有限责任公司珠海分公司",
"number": "440400000383031",
"registrationInstitution": "珠海市市场监督管理局"
}
],
"otherNames": {
"translatedName": [
"Beijing Xiaomi Technology ****"
],
"oldNames": [
"广州长进珠宝首饰有限公司"
]
},
"contactInformation": {
"website": "https://www.mi.com",
"email": [
"[email protected]",
"[email protected]"
],
"phone": [
"400-100-5678",
"010-69630728",
"60606666-1000"
]
},
"shares": {
"shareCapitals": "1850000000.00",
"shareCurrency": "人民币",
"shareType": "Registered"
},
"legalEvents": {
"incorporationDate": "2010-03-03",
"registrationInstitution": "北京市海淀区市场监督管理局"
},
"listed": "N",
"legalRepresentative": "雷军"
},
"associatedEntities": {
"shareholders": [
{
"name": "雷军",
"translatedName": "Lei Jun",
"role": "shareholder",
"providedRole": "自然人股东",
"isCorporate": "false",
"residenceCountry": "中华人民共和国",
"sharePercentage": 77.8,
"shareCapitals": [
{
"numberOfShares": "1439340478.00"
}
],
"shareCurrency": "人民币"
},
{
"name": "义乌兴宸企业管理有限公司",
"translatedName": "Yiwu Xingchen Enterprise Management Co., Ltd.",
"role": "shareholder",
"providedRole": "企业法人",
"isCorporate": "true",
"registrationNumber": "913307825777076000",
"residenceCountry": "中华人民共和国",
"sharePercentage": 10.12,
"shareCapitals": [
{
"numberOfShares": "187243569.00"
}
],
"shareCurrency": "人民币"
}
],
"officers": [
{
"name": "卢伟冰",
"translatedName": "lu weibing",
"role": "officer",
"providedRole": "董事"
},
{
"name": "刘德",
"translatedName": "liu de",
"role": "officer",
"providedRole": "监事"
},
{
"name": "孙谦",
"translatedName": "sun qian",
"role": "officer",
"providedRole": "财务负责人"
}
],
"ultimateBeneficialOwners": []
},
"industryActivityCode": {
"activity": "一般项目：技术服务、技术开发、技术咨询、技术交流、技术转让、技术推广；货物进出口；技术进出口；进出口代理；通讯设备销售；厨具卫具及日用杂品批发；厨具卫具及日用杂品零售；个人卫生用品销售；卫生用品和一次性使用医疗用品销售；日用杂品销售；日用百货销售；日用品销售；化妆品批发；化妆品零售；第一类医疗器械销售；第二类医疗器械销售；玩具销售；体育用品及器材零售；体育用品及器材批发；文具用品零售；文具用品批发；鞋帽批发；鞋帽零售；服装服饰批发；服装服饰零售；钟表销售；眼镜销售（不含隐形眼镜）；针纺织品销售；, 家用电器销售；日用家电零售；家具销售；礼品花卉销售；农作物种子经营（仅限不再分装的包装种子）；照相机及器材销售；照相器材及望远镜批发；照相器材及望远镜零售；工艺美术品及收藏品零售（象牙及其制品除外）；工艺美术品及礼仪用品销售（象牙及其制品除外）；计算机软硬件及辅助设备零售；计算机软硬件及辅助设备批发；珠宝首饰零售；珠宝首饰批发；食用农产品批发；食用农产品零售；宠物食品及用品批发；宠物食品及用品零售；电子产品销售；摩托车及零配件零售；摩托车及零配件批发；电动自行车销售；助动自行车、代步车及零配件销, 售；自行车及零配件零售；自行车及零配件批发；单用途商业预付卡代理销售；商用密码产品销售；五金产品批发；五金产品零售；建筑材料销售；仪器仪表修理；计算机及办公设备维修；办公设备销售；会议及展览服务；组织文化艺术交流活动；广告设计、代理；广告制作；广告发布；摄影扩印服务；票务代理服务；通讯设备修理；移动终端设备制造；可穿戴智能设备制造。（除依法须经批准的项目外，凭营业执照依法自主开展经营活动）许可项目：第三类医疗器械经营；网络文化经营；出版物零售；出版物批发；食品销售；药品零售；广播电视节目制作经营, ；第一类增值电信业务；第二类增值电信业务；在线数据处理与交易处理业务（经营类电子商务）；基础电信业务；互联网信息服务；信息网络传播视听节目。（依法须经批准的项目，经相关部门批准后方可开展经营活动，具体经营项目以相关部门批准文件或许可证件为准）（不得从事国家和本市产业政策禁止和限制类项目的经营活动。）"
},
"providerSpecificData": {
"dateOfLicense": "长期",
"latestAccounts": {
"overdue": false
}
},
"sources": [
{
"name": "State Administration for Market Regulation (国家市场监督管理总局)",
"info": null,
"primary": true,
"fields": [
"$.additionalData.otherIdentifiers[0]",
"$.additionalData.contactInformation.phone",
"$.registrationNumber",
"$.additionalData.otherIdentifiers[1]",
"$.additionalData.shares.shareCapitals",
"$.additionalData.otherIdentifiers[2]",
"$.additionalData.otherNames.englishNames",
"$.additionalData.contactInformation.email",
"$.providedStatus",
"$.additionalData.legalRepresentative",
"$.name",
"$.additionalData.shares.shareCurrency",
"$.status",
"$.additionalData.legalEvents.incorporationDate",
"$.legalForm",
"$.additionalData.otherNames.otherNames",
"$.additionalData.contactInformation.website",
"$.industryActivityCode.activity",
"$.associatedEntities.officers",
"$.associatedEntities.shareholders",
"$.address"
],
"lastCheckedTime": "2025-02-25T15:00:59+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