CHPCS: PSC
A Person with Significant Control (PSC) from Companies House with address and nature of control.
Default definition. This article describes the default
CHPCS definition shipped with DemandFlow. Administrators can add, remove, rename, or re-type fields, change which ones are required, and alter the layout from the Definitions screen in Settings. Your tenant's current schema may differ from what is shown here. To read the current definition at any time, GET the DEFINITION object whose id matches CHPCS.Entity properties
| Property | Value |
|---|---|
| Entity code | CHPCS |
| Display name | PSC |
| Plural | PSCs |
| Level | 100000 |
Use cases
Companies House data entity for PSC (Person with Significant Control) records. Uses 'massive' flag with selective field loading. Three-column General panel: basic info (name, company number), address (premises through country), and nature of control (up to 6 control types, mostly readonly). PSC data is a legal requirement in the UK for transparency of company ownership. Enables beneficial ownership research and compliance checking.
Fields
General: Basic Information
| Field | Type | Required | Notes |
|---|---|---|---|
name | text | Yes | Name. |
companyNumber | text | Company Number. |
General: Address
| Field | Type | Required | Notes |
|---|---|---|---|
premises | text | Premises. | |
address_line_2 | text | Address 2. | |
address_line_3 | text | Address 3. | |
address_line_4 | text | Address 4. | |
locality | text | Locality. | |
postal_code | text | Post code. | |
region | text | Region. | |
country | text | Country. |
General: Nature of control
| Field | Type | Required | Notes |
|---|---|---|---|
nature_of_control0 | text | Read-only. 1. | |
nature_of_control1 | text | 2. | |
nature_of_control2 | text | Read-only. 3. | |
nature_of_control3 | text | Read-only. 4. | |
nature_of_control4 | text | Read-only. 5. | |
nature_of_control5 | text | Read-only. 6. |
Relationships
- No declared relationships in the default definition.
Creating a PSC via the API
POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json
{
"entity": "CHPCS",
"level": 100000,
"comboKey": "SUB:<your-sub-id>|ENT:",
"name": "Name",
"companyNumber": "Company Number",
"premises": "Premises",
"address_line_2": "Address 2"
}Listing PSCs records
GET /v1/entities/CHPCS/SUB