UK establishments

API Changes Information
1

Please see below updated spec for the company profile which now includes extra optional fields for foreign companies. Below this is the spec for UK establishments. This has been implemented to live today.

{
“accounts” : {
“accounting_reference_date” : {
“day” : “integer”,
“month” : “integer”
},
“last_accounts” : {
“made_up_to” : “date”,
“type” : “string”
},
“next_due” : “date”,
“next_made_up_to” : “date”,
“overdue” : “boolean”
},
“annual_return” : {
“last_made_up_to” : “date”,
“next_due” : “date”,
“next_made_up_to” : “date”,
“overdue” : “boolean”
},
“branch_company_details” : {
“business_activity” : “string”,
“parent_company_name” : “string”,
“parent_company_number” : “string”
},
“can_file” : “boolean”,
“company_name” : “string”,
“company_number” : “string”,
“company_status” : null,
“company_status_detail” : “string”,
“confirmation_statement” : {
“last_made_up_to” : “date”,
“next_due” : “date”,
“next_made_up_to” : “date”,
“overdue” : “boolean”
},
“date_of_creation” : “date”,
“date_of_dissolution” : “date”,
“etag” : “string”,
“foreign_company_details” : {
“accounts” : {
“account_period_from” : {
“day” : “integer”,
“month” : “integer”
},
“account_period_to” : {
“day” : “integer”,
“month” : “integer”
},
“accounts_within” : “integer”
},
“accounts_required” : {
“status” : “string”,
“type” : “string”
},
“business_activity” : “string”,
“company_type” : “string”,
“governed_by” : “string”,
“is_a_credit_finance_institution” : “boolean”,
“originating_registry” : {
“country” : “string”,
“name” : “string”
},
“registration_number” : “string”
},
“has_been_liquidated” : “boolean”,
“has_charges” : “boolean”,
“has_insolvency_history” : “boolean”,
“is_community_interest_company” : “boolean”,
“jurisdiction” : “string”,
“last_full_members_list_date” : “date”,
“officer_summary” : {
“active_count” : “integer”,
“officers” : [
{
“appointed_on” : “date”,
“date_of_birth” : {
“day” : “integer”,
“month” : “integer”,
“year” : “integer”
},
“name” : “string”,
“officer_role” : “string”
}
],
“resigned_count” : “integer”
},
“registered_office_address” : {
“address_line_1” : “string”,
“address_line_2” : “string”,
“care_of” : “string”,
“country” : “string”,
“locality” : “string”,
“po_box” : “string”,
“postal_code” : “string”,
“premises” : “string”,
“region” : “string”
},
“registered_office_is_in_dispute” : “boolean”,
“sic_codes” : [
“string”
],
“type” : “string”,
“undeliverable_registered_office_address” : “boolean”
}

UK establishments

{
“etag” : “string”,
“items” : [
{
“company_name” : “string”,
“company_number” : “string”,
“company_status” : “string”,
“links” : {
“company” : “string”
},
“locality” : “string”
}
],
“kind” : “string”,
“links” : {
“self” : “string”
}
}

2

Can you provide clarification on what exactly the additional information is/ which legislation this relates to?

3

In addition, is it possible to supply company numbers of some companies that make use of these fields so we can test systems that consume them.

Sometimes locating companies that meet certain criteria is a bit trial and error/needle in haystack. In the past I’ve had to resort to scraping the API to try and find certain fields and tens of thousands of companies later there are still some fields I have never seen a live example of them being used!

1 Like
4

Hi, if you look at FC007248 you should see which fields are now populated.
This data is currently in our legacy systems which is why we need to add it to CHS.

Cheers

5

These are the additional fields for company profile:-

“foreign_company_details” : {
“accounting_requirement” : {
“foreign_account_type” : “string”,
“terms_of_account_publication” : “string”
},
“accounts” : {
“account_period_from” : {
“day” : “integer”,
“month” : “integer”
},
“account_period_to” : {
“day” : “integer”,
“month” : “integer”
},
“must_file_within” : {
“months” : “integer”
}
},
“business_activity” : “string”,
“company_type” : “string”,
“governed_by” : “string”,
“is_a_credit_finance_institution” : “boolean”,
“originating_registry” : {
“country” : “string”,
“name” : “string”
},
“registration_number” : “string”
},

This data is currently in our legacy systems which is why we need to add it to CHS.