CharlotteHirst/PSCSnapShotAnnotatedFile.html

## PSCSnapShotAnnotatedFile.html
<html>
  <head></head>
  <body>
    <h1>PSC snap shot file</h1>
 <p> Persons with significant control is a new role introduced by the Small Businesss, Employment and Enterprise act. This new data set will be
    available via the API, which is available from the 30th June. These same resources will be used for the streaming API, whcih will return the PSC resources as
    events happen for each company. This will not be available from the 30th June so we will be providing snapshot files, until the stream is available.
    Below are examples of the json from the snapshot file, annotated to explain what each example represents.
</p>
<p>Resource for a person PSC</p>
<code>{"company_number": "09876543","data": {"natures_of_control": ["ownership-of-shares-25-to-50-percent"],"name": "James Brian","links": {"self": "/company/01234567/persons-with-significant-control/individual/L2m6DxTJA0pkUNh9SIcJY8_cdWE"},"etag": "fe416d8a3e09c93eb961ad89b0c606982c3c01e1","name_elements": {"forename": "James","surname": "Brian"},"nationality": "British","country_of_residence": "Wales","address": {"postal_code": "CF14 3UZ","locality": "Cardiff","region": "South Glamorgan","address_line_1": "Crown Way"},"notified_on": "2016-01-01","date_of_birth": {"year": 1988,"month": 4},"kind": "individual-person-with-significant-control"}}</code>

<p>Resource for a legal person (corporate sole) PSC</p>
<code>{"company_number": "09876543","data": {"address": {"region": "Mid Glamorgan","address_line_1": "Rhymney Street","postal_code": "CF42 6BG","premises": "46"},"etag": "kqjwejqwlejqlwjel2","links": {"self": "company/01234567/persons-with-significant-control/legal-person/L2m6DxTJA0pkUNh9SIcJY8_cdWH"},"name": "A Legal Person","natures_of_control": ["ownership-of-shares-50-to-75-percent"],"identification": {"legal_authority": "companies act","legal_form": "limited by shares"},"notified_on": "2015-01-01","kind": "legal-person-person-with-significant-control"}}</code>

<p>Resource for a corporate PSC</p>
<code>{"company_number": "01589850","data": {"address": {"region": "Mid Glamorgan","address_line_1": "Cardiff Street","postal_code": "CF42 6BG","locality": "Treorchy","premises": "46"}, "etag": "kqjwejqwlejqlwjel2","links": {"self": "company/01234567/persons-with-significant-control/corporate-entity/L2m6DxTJA0pkUNh9SIcJY8_cdWF"},"identification": {"country_registered": "England","legal_authority": "Companies act","legal_form": "limited by guarantee","place_registered": "Companies House ","registration_number": "01589850"},"name": "A Company Ltd","natures_of_control": ["ownership-of-shares-50-to-75-percent-as-firm","voting-rights-50-to-75-percent-as-trust"],"notified_on": "2015-01-01","kind": "corporate-entity-person-with-significant-control"}}
</code>

<p>Resource for a person PSC which is linked to a PSC statement </p>
<code>{"company_number": "09876543", "data": {"natures_of_control": ["ownership-of-shares-25-to-50-percent"],"name": "James Potter","links": {"self": "/company/01234567/persons-with-significant-control/individual/L2m6DxTJA0pkUNh9SIcJY8_cdWE","statement": "company/01234567/persons-with-significant-control-statements/6q7G5BaVhNHjwLTHHU-fMuF9gk4"},"etag": "fe416d8a3e09c93eb961ad89b0c606982c3c01e1","name_elements": {"forename": "James","surname": "Potter"},"nationality": "British","country_of_residence": "Wales","address": {"postal_code": "CF14 3UZ","locality": "Cardiff","region": "South Glamorgan","address_line_1": "Crown Way"},"notified_on": "2016-01-01","date_of_birth": {"year": 1981,"month": 4},"kind": "individual-person-with-significant-control"}}
</code>

<p>Resource for a linked PSC statement, with the link to the person PSC</p>
<code>{"company_number": "09876543","data": {"etag": "d1cdbf470d56f95c8f9882ee65a322fba83430cb","statement": "psc-has-failed-to-confirm-changed-details","links": {"self": "/company/00006400/persons-with-significant-control-statements/qY2HsmhZ7P6zbUmjkIrlyjTEYBg","person_with_significant_control": "/company/01234567/persons-with-significant-control/L2m6DxTJA0pkUNh9SIcJY8_cdWE"},"kind": "persons-with-significant-control-statement","linked_psc_name": "James Potter","notified_on": "2016-03-02"}}
</code>

<p>Resource for a restrictions statement, with the reason how it was withdrawn and the date it was withdrawn on</p>
<code>{"company_number": "09876543","data": {"etag": "d1cdbf470d56f95c8f9882ee65a322fba83430cb","statement": "restrictions-notice-issued-to-psc","restrictions_notice_withdrawal_reason": "restrictions-notice-withdrawn-by-court-order","links": {"self": "/company/00006400/persons-with-significant-control-statements/qY2HsmhZ7P6zbUmjkIrlyjTEYBg"},"kind": "persons-with-significant-control-statement","ceased_on": "2016-06-02","notified_on": "2016-03-02"}}
</code>

<p>Resource for a legal person PSC, which has been ceased to be a PSC with ceased date</p>
<code>{"company_number": "09876543","data": {"address": {"region": "Mid Glamorgan","address_line_1": "Rhymney Street","postal_code": "CF42 6BG","premises": "46"},"etag": "kqjwejqwlejqlwjel2","links": {"self": "company/01234567/persons-with-significant-control/legal-person/L2m6DxTJA0pkUNh9SIcJY8_cdWH"},"name": "A Legal Person","natures_of_control": ["voting-rights-25-to-50-percent"],"identification": {"legal_authority": "companies act","legal_form": "limited by shares"},"notified_on": "2016-06-01","ceased_on": "2016-08-11","kind": "legal-person-person-with-significant-control"}}
</code>

<p>Resource for a super secure (protected under 790ZG) PSC</p>
<code>{"company_number": "09876543","data": {"etag": "kqjwejqwlejqlwjel2","links": {"self": "company/01234567/persons-with-significant-control/super-secure/L2m6DxTJA0pkUNh9SIcJY8_cdWH"},"kind": "super-secure-person-with-significant-control","description": "super-secure-persons-with-significant-control"}}
</code>
  </body>
</html>
	<html>
	<head></head>
	<body>
	<h1>PSC snap shot file</h1>
	<p> Persons with significant control is a new role introduced by the Small Businesss, Employment and Enterprise act. This new data set will be
	available via the API, which is available from the 30th June. These same resources will be used for the streaming API, whcih will return the PSC resources as
	events happen for each company. This will not be available from the 30th June so we will be providing snapshot files, until the stream is available.
	Below are examples of the json from the snapshot file, annotated to explain what each example represents.
	</p>
	<p>Resource for a person PSC</p>
	<code>{"company_number": "09876543","data": {"natures_of_control": ["ownership-of-shares-25-to-50-percent"],"name": "James Brian","links": {"self": "/company/01234567/persons-with-significant-control/individual/L2m6DxTJA0pkUNh9SIcJY8_cdWE"},"etag": "fe416d8a3e09c93eb961ad89b0c606982c3c01e1","name_elements": {"forename": "James","surname": "Brian"},"nationality": "British","country_of_residence": "Wales","address": {"postal_code": "CF14 3UZ","locality": "Cardiff","region": "South Glamorgan","address_line_1": "Crown Way"},"notified_on": "2016-01-01","date_of_birth": {"year": 1988,"month": 4},"kind": "individual-person-with-significant-control"}}</code>

	<p>Resource for a legal person (corporate sole) PSC</p>
	<code>{"company_number": "09876543","data": {"address": {"region": "Mid Glamorgan","address_line_1": "Rhymney Street","postal_code": "CF42 6BG","premises": "46"},"etag": "kqjwejqwlejqlwjel2","links": {"self": "company/01234567/persons-with-significant-control/legal-person/L2m6DxTJA0pkUNh9SIcJY8_cdWH"},"name": "A Legal Person","natures_of_control": ["ownership-of-shares-50-to-75-percent"],"identification": {"legal_authority": "companies act","legal_form": "limited by shares"},"notified_on": "2015-01-01","kind": "legal-person-person-with-significant-control"}}</code>

	<p>Resource for a corporate PSC</p>
	<code>{"company_number": "01589850","data": {"address": {"region": "Mid Glamorgan","address_line_1": "Cardiff Street","postal_code": "CF42 6BG","locality": "Treorchy","premises": "46"}, "etag": "kqjwejqwlejqlwjel2","links": {"self": "company/01234567/persons-with-significant-control/corporate-entity/L2m6DxTJA0pkUNh9SIcJY8_cdWF"},"identification": {"country_registered": "England","legal_authority": "Companies act","legal_form": "limited by guarantee","place_registered": "Companies House ","registration_number": "01589850"},"name": "A Company Ltd","natures_of_control": ["ownership-of-shares-50-to-75-percent-as-firm","voting-rights-50-to-75-percent-as-trust"],"notified_on": "2015-01-01","kind": "corporate-entity-person-with-significant-control"}}
	</code>

	<p>Resource for a person PSC which is linked to a PSC statement </p>
	<code>{"company_number": "09876543", "data": {"natures_of_control": ["ownership-of-shares-25-to-50-percent"],"name": "James Potter","links": {"self": "/company/01234567/persons-with-significant-control/individual/L2m6DxTJA0pkUNh9SIcJY8_cdWE","statement": "company/01234567/persons-with-significant-control-statements/6q7G5BaVhNHjwLTHHU-fMuF9gk4"},"etag": "fe416d8a3e09c93eb961ad89b0c606982c3c01e1","name_elements": {"forename": "James","surname": "Potter"},"nationality": "British","country_of_residence": "Wales","address": {"postal_code": "CF14 3UZ","locality": "Cardiff","region": "South Glamorgan","address_line_1": "Crown Way"},"notified_on": "2016-01-01","date_of_birth": {"year": 1981,"month": 4},"kind": "individual-person-with-significant-control"}}
	</code>

	<p>Resource for a linked PSC statement, with the link to the person PSC</p>
	<code>{"company_number": "09876543","data": {"etag": "d1cdbf470d56f95c8f9882ee65a322fba83430cb","statement": "psc-has-failed-to-confirm-changed-details","links": {"self": "/company/00006400/persons-with-significant-control-statements/qY2HsmhZ7P6zbUmjkIrlyjTEYBg","person_with_significant_control": "/company/01234567/persons-with-significant-control/L2m6DxTJA0pkUNh9SIcJY8_cdWE"},"kind": "persons-with-significant-control-statement","linked_psc_name": "James Potter","notified_on": "2016-03-02"}}
	</code>

	<p>Resource for a restrictions statement, with the reason how it was withdrawn and the date it was withdrawn on</p>
	<code>{"company_number": "09876543","data": {"etag": "d1cdbf470d56f95c8f9882ee65a322fba83430cb","statement": "restrictions-notice-issued-to-psc","restrictions_notice_withdrawal_reason": "restrictions-notice-withdrawn-by-court-order","links": {"self": "/company/00006400/persons-with-significant-control-statements/qY2HsmhZ7P6zbUmjkIrlyjTEYBg"},"kind": "persons-with-significant-control-statement","ceased_on": "2016-06-02","notified_on": "2016-03-02"}}
	</code>

	<p>Resource for a legal person PSC, which has been ceased to be a PSC with ceased date</p>
	<code>{"company_number": "09876543","data": {"address": {"region": "Mid Glamorgan","address_line_1": "Rhymney Street","postal_code": "CF42 6BG","premises": "46"},"etag": "kqjwejqwlejqlwjel2","links": {"self": "company/01234567/persons-with-significant-control/legal-person/L2m6DxTJA0pkUNh9SIcJY8_cdWH"},"name": "A Legal Person","natures_of_control": ["voting-rights-25-to-50-percent"],"identification": {"legal_authority": "companies act","legal_form": "limited by shares"},"notified_on": "2016-06-01","ceased_on": "2016-08-11","kind": "legal-person-person-with-significant-control"}}
	</code>

	<p>Resource for a super secure (protected under 790ZG) PSC</p>
	<code>{"company_number": "09876543","data": {"etag": "kqjwejqwlejqlwjel2","links": {"self": "company/01234567/persons-with-significant-control/super-secure/L2m6DxTJA0pkUNh9SIcJY8_cdWH"},"kind": "super-secure-person-with-significant-control","description": "super-secure-persons-with-significant-control"}}
	</code>
	</body>
	</html>