# UK establishments

**URL:** <http://forum.companieshouse.gov.uk/t/uk-establishments/597>\
**Category:** Information\
**Created:** [May 24, 2016, 12:53pm UTC](http://forum.companieshouse.gov.uk/t/uk-establishments/597 "2016-05-24T12:53:48Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![pfrancis](http://forum.companieshouse.gov.uk/letter_avatar_proxy/v4/letter/p/2bfe46/32.png) [@pfrancis](http://forum.companieshouse.gov.uk/u/pfrancis)\
**Post date:** [May 24, 2016, 12:53pm UTC](http://forum.companieshouse.gov.uk/t/uk-establishments/597/1 "2016-05-24T12:53:48Z")

</div>

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”  
}  
}

---

<div class="post-metadata">

**Author:** ![h\_brackmann](http://forum.companieshouse.gov.uk/letter_avatar_proxy/v4/letter/h/d2c977/32.png) [@h\_brackmann](http://forum.companieshouse.gov.uk/u/h_brackmann)\
**Post date:** [May 25, 2016, 11:22am UTC](http://forum.companieshouse.gov.uk/t/uk-establishments/597/2 "2016-05-25T11:22:19Z")

</div>

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

---

<div class="post-metadata">

**Author:** ![ash](http://forum.companieshouse.gov.uk/letter_avatar_proxy/v4/letter/a/f19dbf/32.png) [@ash](http://forum.companieshouse.gov.uk/u/ash)\
**Post date:** [May 25, 2016, 1:55pm UTC](http://forum.companieshouse.gov.uk/t/uk-establishments/597/3 "2016-05-25T13:55:24Z")

</div>

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!

---

<div class="post-metadata">

**Author:** ![pfrancis](http://forum.companieshouse.gov.uk/letter_avatar_proxy/v4/letter/p/2bfe46/32.png) [@pfrancis](http://forum.companieshouse.gov.uk/u/pfrancis)\
**Post date:** [May 25, 2016, 2:25pm UTC](http://forum.companieshouse.gov.uk/t/uk-establishments/597/4 "2016-05-25T14:25:16Z")

</div>

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

---

<div class="post-metadata">

**Author:** ![pfrancis](http://forum.companieshouse.gov.uk/letter_avatar_proxy/v4/letter/p/2bfe46/32.png) [@pfrancis](http://forum.companieshouse.gov.uk/u/pfrancis)\
**Post date:** [May 25, 2016, 2:34pm UTC](http://forum.companieshouse.gov.uk/t/uk-establishments/597/5 "2016-05-25T14:34:56Z")

</div>

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.
