Developer news
KYC API: Upcoming changes within our connection to UK Companies House
Posted 2025-02-11
|
Updated 2025-02-12
Summary
We would like to inform you that we have scheduled the implementation of several changes to our connection with the UK register. In this release, we are aiming for the following improvements available with the 26th of February 2025’s release.
- We will enhance our status and provided status mapping.
- Officers who have resigned from their positions will no longer be displayed.
- The field officer role and occupation will be implemented.
- Data quality issues and inconsistencies within addresses will be resolved through the following alignment with the UK register format:
Response before
{
"datasetId": "11DD20346B52DAA0D5347D393887B74A",
"kompanyId": "8CD5393BF67230B37806559529AF1229",
"datasetName": "refresh",
"datasetOptions": null,
"info": null,
"status": "COMPLETED",
"requestTime": "2025-01-29T14:08:52+00:00",
"responseTime": "2025-01-29T14:08:56+00:00",
"estimatedDeliverySeconds": 22,
"content": {
"kompanyId": "8CD5393BF67230B37806559529AF1229",
"countryCode": "UK",
"countryName": "United Kingdom",
"state": null,
"registrationNumber": "00028296",
"name": "LISTER & CO. PUBLIC LIMITED COMPANY",
"status": "LIVE",
"providedStatus": "Active",
"address": "PO BOX 61, Cloth Hall Court, 14 King Street Leeds, West Yorkshire, LS1 2JN",
"legalForm": "plc",
"additionalData": {
"otherIdentifiers": [
{
"identifierName": "localNumber",
"identifierValue": "00028296"
}
],
"contactInformation": {
"formattedAddress": {
"number": "PO BOX",
"street": "61",
"zip": "LS1 2JN",
"district": "Cloth Hall Court",
"city": "14 King Street Leeds",
"region": "West Yorkshire"
}
},
"legalEvents": {
"incorporationDate": "1889-02-20",
"dissolutionDate": "2016-12-27"
}
},
"associatedEntities": {
"shareholders": [],
"officers": [
{
"name": "CANT, Anthony Pinnington",
"role": "managingDirector",
"isCorporate": false,
"address": "Eardington Manor, Near Bridgnorth, Shropshire, WV16 5JZ",
"startDate": "1995-10-26",
"dateOfBirth": "1941-04",
"nationality": "British",
"additionalAssociatedEntityData": {
"status": "CURRENT",
"occupation": "Company Director"
}
},
{
"name": "SUTCLIFFE, Steven Roger",
"role": "secretary",
"isCorporate": false,
"address": "32 Woodside Park Drive, Horsforth, Leeds, West Yorkshire, LS18 4TG",
"startDate": "1995-06-30",
"nationality": "British",
"additionalAssociatedEntityData": {
"status": "CURRENT"
}
},
{
"name": "KITCHEN, John Martin",
"role": "secretary",
"isCorporate": false,
"address": "Appleby Blake Hall Drive, Mirfield, West Yorkshire, WF14 9NG",
"endDate": "1995-06-30",
"nationality": "British",
"additionalAssociatedEntityData": {
"status": "RESIGNED"
}
}
]
},
"industryActivityCode": {
"activityCodes": [
"1711",
"1712",
"1721",
"1722"
]
},
"providerSpecificData": {
"latestAccounts": {
"overdue": false
}
},
"sources": [
{
"name": "Companies House",
"info": null,
"primary": true,
"fields": [
"$.status",
"$.additionalData.legalEvents.incorporationDate",
"$.legalForm",
"$.industryActivityCode.activityCodes",
"$.registrationNumber",
"$.additionalData.otherIdentifiers[0]",
"$.providedStatus",
"$.additionalData.legalEvents.dissolutionDate",
"$.name",
"$.additionalData.contactInformation.formattedAddress",
"$.associatedEntities.officers"
],
"lastCheckedTime": "2025-01-29T14:08:56+00:00"
}
],
"version": "company-v2.0"
}
}
Response after
datasetId": "11DD20346B52DAA0D5347D393887B74A",
"kompanyId": "8CD5393BF67230B37806559529AF1229",
"datasetName": "refresh",
"datasetOptions": null,
"info": null,
"status": "COMPLETED",
"requestTime": "2025-01-29T14:08:52+00:00",
"responseTime": "2025-01-29T14:08:56+00:00",
"estimatedDeliverySeconds": 22,
"content": {
"kompanyId": "8CD5393BF67230B37806559529AF1229",
"countryCode": "UK",
"countryName": "United Kingdom",
"state": null,
"registrationNumber": "00028296",
"name": "LISTER & CO. PUBLIC LIMITED COMPANY",
"status": "LIVE",
"providedStatus": "Active",
"address": "PO BOX 61, Cloth Hall Court, 14 King Street Leeds, West Yorkshire, LS1 2JN",
"legalForm": "plc",
"additionalData": {
"otherIdentifiers": [
{
"identifierName": "localNumber",
"identifierValue": "00028296"
}
],
"contactInformation": {
"formattedAddress": {
"address_line_1": "PO BOX 61",
"address_line_2": "Cloth Hall Court",
"zip": "LS1 2JN",
"city": "14 King Street Leeds",
"region": "West Yorkshire"
}
},
"legalEvents": {
"incorporationDate": "1889-02-20",
"dissolutionDate": "2016-12-27"
}
},
"associatedEntities": {
"shareholders": [],
"officers": [
{
"name": "CANT, Anthony Pinnington",
"role": "managingDirector",
"isCorporate": false,
"address": "Eardington Manor, Near Bridgnorth, Shropshire, WV16 5JZ",
"startDate": "1995-10-26",
"dateOfBirth": "1941-04",
"nationality": "British",
"additionalAssociatedEntityData": {
"status": "CURRENT",
"occupation": "Company Director"
}
},
{
"name": "SUTCLIFFE, Steven Roger",
"role": "secretary",
"isCorporate": false,
"address": "32 Woodside Park Drive, Horsforth, Leeds, West Yorkshire, LS18 4TG",
"startDate": "1995-06-30",
"nationality": "British",
"additionalAssociatedEntityData": {
"status": "CURRENT"
}
}
]
},
"industryActivityCode": {
"activityCodes": [
"1711",
"1712",
"1721",
"1722"
]
},
"providerSpecificData": {
"latestAccounts": {
"overdue": false
}
},
"sources": [
{
"name": "Companies House",
"info": null,
"primary": true,
"fields": [
"$.status",
"$.additionalData.legalEvents.incorporationDate",
"$.legalForm",
"$.industryActivityCode.activityCodes",
"$.registrationNumber",
"$.additionalData.otherIdentifiers[0]",
"$.providedStatus",
"$.additionalData.legalEvents.dissolutionDate",
"$.name",
"$.additionalData.contactInformation.formattedAddress",
"$.associatedEntities.officers"
],
"lastCheckedTime": "2025-01-29T14:08:56+00:00"
}
],
"version": "company-v2.0"
}
}
If you would like to provide us with feedback or you have a question related to this, contact us here: support team.