Developer news
KYC API: Upcoming changes within our connection to UK Companies House
Posted 2025-02-11
|
Updated 2025-04-03
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": "951A2168D4500FA0400A6F6D60BA39AF",
"kompanyId": "4424FBA6E7D2E6F922C82925BB314B14",
"datasetName": "refresh",
"datasetOptions": null,
"info": null,
"status": "COMPLETED",
"requestTime": "2025-04-03T09:49:22+00:00",
"responseTime": "2025-04-03T09:49:23+00:00",
"estimatedDeliverySeconds": 4,
"content": {
"kompanyId": "4424FBA6E7D2E6F922C82925BB314B14",
"countryCode": "UK",
"countryName": "United Kingdom",
"state": null,
"registrationNumber": "04736472",
"name": "BLACK & WHITE BARBER SHOP LIMITED",
"status": "LIVE",
"providedStatus": "Active",
"address": "Care Of Jfs Torbitt, 58 Durham Road, Birtley, Chester Le Street, Tyne And Wear, DH3 2QJ, England",
"legalForm": "ltd",
"additionalData": {
"otherIdentifiers": [
{
"identifierName": "localNumber",
"identifierValue": "04736472"
},
{
"identifierName": "orbisId",
"identifierValue": "011226866"
}
],
"contactInformation": {
"formattedAddress": {
"number": "Care Of Jfs Torbitt",
"street": "58 Durham Road",
"zip": "DH3 2QJ",
"district": "Birtley",
"city": "Chester Le Street",
"region": "Tyne And Wear",
"country": "England"
}
},
"legalEvents": {
"incorporationDate": "2003-04-16"
}
},
"associatedEntities": {
"shareholders": [],
"officers": [
{
"name": "COMPANY DIRECTORS LIMITED",
"role": "managingDirector",
"isCorporate": true,
"address": "788-790 Finchley Road, London, NW11 7TJ",
"startDate": "2003-04-16",
"endDate": "2003-04-16",
"additionalAssociatedEntityData": {
"status": "RESIGNED"
}
},
{
"name": "JACKSON, Susan",
"role": "managingDirector",
"isCorporate": false,
"address": "Care Of Jfs Torbitt, 58, Durham Road, Birtley, Chester Le Street, Tyne And Wear, DH3 2QJ, England",
"startDate": "2003-04-16",
"endDate": "2022-12-06",
"dateOfBirth": "1951-05",
"nationality": "English",
"residenceCountry": "England",
"additionalAssociatedEntityData": {
"status": "RESIGNED",
"occupation": "Company Director"
}
},
{
"name": "CLARK, George",
"role": "managingDirector",
"isCorporate": false,
"address": "Care Of Jfs Torbitt, 58, Durham Road, Birtley, Chester Le Street, Tyne And Wear, DH3 2QJ, England",
"startDate": "2003-04-16",
"dateOfBirth": "1959-02",
"nationality": "English",
"residenceCountry": "England",
"additionalAssociatedEntityData": {
"status": "CURRENT",
"occupation": "Company Director"
}
},
{
"name": "TEMPLE SECRETARIES LIMITED",
"role": "secretary",
"isCorporate": true,
"address": "788-790 Finchley Road, London, NW11 7TJ",
"startDate": "2003-04-16",
"endDate": "2003-04-16",
"additionalAssociatedEntityData": {
"status": "RESIGNED"
}
},
{
"name": "JACKSON, Susan",
"role": "secretary",
"isCorporate": false,
"address": "58, Earnshaw Way, Beaumont Park, Whitley Bay, Tyne & Wear, NE25 9UN, United Kingdom",
"startDate": "2003-04-16",
"endDate": "2022-12-06",
"nationality": "English",
"additionalAssociatedEntityData": {
"status": "RESIGNED",
"occupation": "Company Director"
}
}
]
},
"industryActivityCode": {
"activityCodes": [
"68209"
]
},
"providerSpecificData": {
"latestAccounts": {
"category": "micro-entity",
"lastMadeUpDate": "2023-04-30",
"nextDueDate": "2025-01-31",
"overdue": false,
"referenceDate": "30-04"
}
},
"sources": [
{
"name": "Companies House",
"info": null,
"primary": true,
"fields": [
"$.status",
"$.additionalData.legalEvents.incorporationDate",
"$.legalForm",
"$.additionalData.otherIdentifiers[1]",
"$.industryActivityCode.activityCodes",
"$.registrationNumber",
"$.additionalData.otherIdentifiers[0]",
"$.providedStatus",
"$.additionalData.legalEvents.dissolutionDate",
"$.name",
"$.providerSpecificData.latestAccounts.category",
"$.additionalData.contactInformation.formattedAddress",
"$.associatedEntities.officers"
],
"lastCheckedTime": "2024-04-15T08:58:43+00:00"
}
],
"version": "company-v2.0"
}
}
Response after
{
"datasetId": "89019048E3CAF607EF4B57831143F7F5",
"kompanyId": "4424FBA6E7D2E6F922C82925BB314B14",
"datasetName": "refresh",
"datasetOptions": null,
"info": null,
"status": "COMPLETED",
"requestTime": "2025-04-03T09:49:53+00:00",
"responseTime": "2025-04-03T09:49:56+00:00",
"estimatedDeliverySeconds": 21,
"content": {
"kompanyId": "4424FBA6E7D2E6F922C82925BB314B14",
"countryCode": "UK",
"countryName": "United Kingdom",
"state": null,
"registrationNumber": "04736472",
"name": "BLACK & WHITE BARBER SHOP LIMITED",
"status": "LIVE",
"providedStatus": "Active",
"address": "Care Of Jfs Torbitt, 58 Durham Road, Birtley, Chester Le Street, Tyne And Wear, DH3 2QJ, England",
"legalForm": "ltd",
"additionalData": {
"otherIdentifiers": [
{
"identifierName": "localNumber",
"identifierValue": "04736472"
}
],
"contactInformation": {
"formattedAddress": {
"addressLine1": "Care Of Jfs Torbitt, 58 Durham Road",
"addressLine2": "Birtley",
"zip": "DH3 2QJ",
"city": "Chester Le Street",
"region": "Tyne And Wear",
"country": "England"
}
},
"legalEvents": {
"incorporationDate": "2003-04-16"
}
},
"associatedEntities": {
"shareholders": [],
"officers": [
{
"name": "CLARK, George",
"role": "managingDirector",
"providedRole": "director",
"isCorporate": false,
"address": "Durham Road, Birtley, Chester Le Street, Tyne And Wear, DH3 2QJ, England",
"startDate": "2003-04-16",
"dateOfBirth": "1959-02",
"nationality": "English",
"residenceCountry": "England",
"additionalAssociatedEntityData": {
"occupation": "Company Director"
}
}
]
},
"industryActivityCode": {
"activityCodes": [
"68209"
]
},
"providerSpecificData": {
"latestAccounts": {
"category": "micro-entity",
"lastMadeUpDate": "2024-04-30",
"nextDueDate": "2026-01-31",
"overdue": false,
"referenceDate": "30-04"
}
},
"sources": [
{
"name": "Companies House",
"info": null,
"primary": true,
"fields": [
"$.status",
"$.additionalData.legalEvents.incorporationDate",
"$.legalForm",
"$.industryActivityCode.activityCodes",
"$.registrationNumber",
"$.additionalData.otherIdentifiers[0]",
"$.providedStatus",
"$.name",
"$.providerSpecificData.latestAccounts.category",
"$.additionalData.contactInformation.formattedAddress",
"$.associatedEntities.officers"
],
"lastCheckedTime": "2025-04-03T09:49: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.