Officers

Output

Attribute	Type	Description
activeCount	integer	The count of active officers.
etag	string	The ETag of the resource.
items	array<object>	The list of officers.
links	object	Links to other resources associated with this officer list resource.
kind	string	Possible values are: officer-list
resignedCount	number	The number of resigned officers in this result set.
totalResults	number	The total number of officers in this result set.

Officer Item

Attribute	Type	Description
address	object	The correspondence address of the officer.
appointedBefore	date	The date before which the officer was appointed.
appointedOn	date	The date on which the officer was appointed.
contactDetails	object	The contact name for the officer.
countryOfResidence	string	The country of residence of the officer.
dateOfBirth	object	The day of birth of the officer.
etag	string	The ETag of the officer's resource.
formerNames	object	The former forenames of the officer.
identification	object	The type of identification for the officer.
isPre1992Appointment	boolean	Flag indicating if the appointment was made before 1992.
links	object	Links to other resources associated with this officer list item.
name	string	The name of the officer.
nationality	string	The nationality of the officer.
occupation	string	The occupation of the officer.
officerRole	string	The role of the officer.
principalOfficeAddress	object	The principal/registered office address.
resignedOn	date	The date on which the officer resigned.
responsibilities	string	The responsibilities of the officer.
appointments	array<object>	Officer appointment list.
naturalOfficerDisqualifications	array<object>	Natural officers disqualifications. Only present is of natural type.
corporateOfficerDisqualifications	array<object>	Corporate officers disqualifications. Only present is of corporate type.

Officers Link

Attribute	Type	Description
self	string	Link to this officer list resource.

Address

Attribute	Type	Description
addressLine1	string	The first line of the officer's address.
addressLine2	string	The second line of the officer's address.
careOf	string	The care of name for the officer's address.
country	string	The country of the officer's address.
locality	string	The locality of the officer's address.
poBox	string	The post-office box number of the officer's address.
postalCode	string	The postal code of the officer's address.
premises	string	The property name or number of the officer's address.
region	string	The region of the officer's address.

Contact Details

Attribute	Type	Description
contactName	string	The contact name for the officer.

Former Names

Attribute	Type	Description
forenames	string	The former forenames of the officer.
surname	string	The former surname of the officer.

Identification

Attribute	Type	Description
identificationType	string	The type of identification for the officer.
legalAuthority	string	The legal authority that issued the identification.
legalForm	string	The legal form associated with the identification.
placeRegistered	string	The place where the identification was registered.
registrationNumber	string	The registration number associated with the identification.

Links

Attribute	Type	Description
officer.appointments	string	The link to the officer's appointments resource
self	string	The link to the officer's resource

Date of Birth

Attribute	Type	Description
day	number	The day of birth of the officer.
month	number	The month of birth of the officer.
year	number	The year of birth of the officer.

Principal Office Address

Attribute	Type	Description
addressLine1	string	The first line of the principal office address.
addressLine2	string	The second line of the principal office address.
careOf	string	The care of name for the principal office address.
country	string	The country e.g. United Kingdom.
locality	string	The locality e.g. London.
poBox	string	The post-office box number.
postalCode	string	The postal code e.g. CF14 3UZ.
premises	string	The property name or number.
region	string	The region e.g. Surrey.

Appointments

Attribute	Type	Description
dateOfBirth	object	Date of birth of the appointed officer.
etag	string	ETag of the appointed officer's resource.
isCorporateOfficer	boolean	Flag indicating if officer is corporate.
items	array<object>	Array of appointed officer's appointments.
links	object	Links related to the appointment.
name	string	Name of the appointed officer.
startIndex	number	Start index of the appointment response.
totalResults	number	Total number of results in the appointment response.
kind	string	Kind of the appointed officer's appointments response.

Appointment Date of Birth

Attribute	Type	Description
month	number	Month of birth of the appointed officer.
year	number	Year of birth of the appointed officer.

Appointment Links

Attribute	Type	Description
self	string	Link to this officer appointment resource.

Appointment Item

Attribute	Type	Description
address	object	The correspondence address of the officer.
appointedBefore	date	The date the officer was appointed before. Only present when the is_pre_1992_appointment attribute is true.
appointedOn	date	The date on which the officer was appointed.
appointedTo	object	The company information of the appointment.
contactDetails	object	The contact at the corporate-managing-officer of a registered-overseas-entity.
countryOfResidence	string	The officer's country of residence.
formerNames	array<object>	Former names for the officer, if there are any.
identification	object	Only one from eea, non-eea, uk-limited, other-corporate-body-or-firm or registered-overseas-entity-corporate-managing-officer can be supplied, not multiples of them.
isPre1992Appointment	boolean	Indicator representing if the officer was appointed before their appointment date.
links	object	Links to other resources associated with this officer appointment item.
name	string	The full name of the office.
nameElements	object	A document encapsulating the separate elements of a natural officer's name.
nationality	string	The officer's nationality.
occupation	string	The officer's occupation.
officerRole	string	Possible values are: cic-manager corporate-director corporate-llp-designated-member corporate-llp-member corporate-managing-officer corporate-member-of-a-management corporate-member-of-a-supervisory-organ corporate-member-of-an-administrative-organ corporate-nominee-director corporate-nominee-secretary corporate-secretary director judicial-factor llp-designated-member llp-member managing-officer member-of-a-management member-of-a-supervisory-organ member-of-an-administrative-organ nominee-director nominee-secretary receiver-and-manager secretary
principalOfficeAddress	object	The principal/registered office address.
resignedOn	date	The date the officer was resigned.
responsibilities	string	The responsibilities of the managing officer.

Appointed To

Attribute	Type	Description
companyName	string	Name of the company to which the appointed officer is appointed.
companyNumber	string	Number of the company to which the appointed officer is appointed.
companyStatus	string	Status of the company to which the appointed officer is appointed.

Contact Details

Attribute	Type	Description
contactName	string	Contact name for the appointed officer.

Appointment Item Links

Attribute	Type	Description
company	string	Link to the company profile resource that this appointment is associated with.

Name Elements

Attribute	Type	Description
forename	string	Forename of the appointed officer.
honours	string	Honours an officer might have.
otherForenames	string	Other forenames of the appointed officer.
surname	string	Surname of the appointed officer.
title	string	Title of the appointed officer.

Corporate Officer Disqualifications

Property	Type	Description
companyNumber	string	Registration number of the disqualified officer.
countryOfRegistration	string	Country in which the disqualified officer was registered.
disqualifications	array	Array of the officer's disqualifications.
etag	string	ETag of the resource.
kind	string	Kind of the disqualification. Possible values are: corporate-disqualification
links	object	Links to other resources associated with this officer disqualification resource.
name	string	Name of the disqualified officer.
permissionsToAct	array<object>	Permissions that the disqualified officer has to act outside of their disqualification.

Natural Officer Disqualifications

Property	Type	Description
dateOfBirth	date	Disqualified officer's date of birth.
disqualifications	array<object>	Array of the officer's disqualifications.
etag	string	ETag of the resource.
forename	string	Forename of the disqualified officer.
honours	string	Honours of the disqualified officer.
kind	string	Kind of the disqualification.
links	object	Links to other resources associated with this officer disqualification resource.
nationality	string	Nationality of the disqualified officer.
otherForenames	string	Other forenames of the disqualified officer.
permissionsToAct	array	Permissions to act that have been granted for the disqualified officer.
surname	string	Surname of the disqualified officer
title	string	Title of the disqualified officer.

Officer Disqualification

Property	Type	Description
address	object	Address of the disqualified officer as provided by the disqualifying authority.
caseIdentifier	string	Case identifier of the disqualification.
companyNames	array<string>	Companies in which the misconduct took place.
courtName	string	Name of the court that handled the disqualification case.
disqualificationType	string	Type of disqualification authority that handled the case.
disqualifiedFrom	date	Date that the disqualification starts.
disqualifiedUntil	date	Date that the disqualification ends.
heardOn	date	Date that the disqualification hearing was on.
lastVariation	array<object>	Latest variation made to the disqualification.
reason	object	Reason for the disqualification.
undertakenOn	date	Date that the disqualification undertaking was agreed on.

Officer Disqualifications Links

Attribute	Type	Description
self	string	Link to this disqualification resource.

Last Variation

Property	Type	Description
caseIdentifier	string	Case identifier of the variation.
courtName	string	Name of the court that handled the variation case.
variedOn	date	Date the variation was made against the disqualification.

Reason

Property	Type	Description
act	string	Law under which the disqualification was made.
article	string	Article of the act under which the disqualification was made (if applicable).
descriptionIdentifier	string	Description for the reason of disqualification.
section	string	Section of the act under which the disqualification was made (if applicable).

Permissions To Act

Property	Type	Description
companyNames	array<string>	Companies for which the disqualified officer has permission to act.
courtName	string	Name of the court that granted the permission to act.
expiresOn	date	Date that the permission ends.
grantedOn	date	Date that the permission starts.

Example

{
    "activeCount": 100,
    "etag": "abc123",
    "items": [
        {
            "address": {
                "addressLine1": "123 Main Street",
                "addressLine2": "Apt 456",
                "careOf": "John Doe",
                "country": "United States",
                "locality": "Cityville",
                "poBox": "789",
                "postalCode": "12345",
                "premises": "Building A",
                "region": "Stateville"
            },
            "appointedBefore": "2022-01-01",
            "appointedOn": "2023-02-15",
            "contactDetails": {
                "contactName": "Jane Smith"
            },
            "countryOfResidence": "United States",
            "dateOfBirth": {
                "day": 10,
                "month": 5,
                "year": 1980
            },
            "etag": "def456",
            "formerNames": [
                {
                    "forenames": "John",
                    "surname": "Doe"
                }
            ],
            "identification": {
                "identificationType": "Passport",
                "legalAuthority": "US Government",
                "legalForm": "Individual",
                "placeRegistered": "Cityville",
                "registrationNumber": "ABC123"
            },
            "isPre1992Appointment": true,
            "links": {
                "officer": {
                    "appointments": "https://example.com/appointments/123"
                },
                "self": "https://example.com/officer/123"
            },
            "name": "John Doe",
            "nationality": "American",
            "occupation": "Business Executive",
            "officerRole": "Director",
            "principalOfficeAddress": {
                "addressLine1": "456 Elm Street",
                "addressLine2": "Suite 789",
                "careOf": "Jane Smith",
                "country": "United States",
                "locality": "Townsville",
                "poBox": "123",
                "postalCode": "54321",
                "premises": "Office Tower",
                "region": "Stateville"
            },
            "resignedOn": "2023-07-31",
            "responsibilities": "Overseeing company operations",
            "appointments": [
                {
                    "dateOfBirth": {
                        "month": "integer",
                        "year": "integer"
                    },
                    "etag": "string",
                    "isCorporateOfficer": "boolean",
                    "items": [
                        {
                            "address": {
                                "addressLine1": "string",
                                "addressLine2": "string",
                                "careOf": "string",
                                "country": "string",
                                "locality": "string",
                                "poBox": "string",
                                "postalCode": "string",
                                "premises": "string",
                                "region": "string"
                            },
                            "appointedBefore": "date",
                            "appointedOn": "date",
                            "appointedTo": {
                                "companyName": "string",
                                "companyNumber": "string",
                                "companyStatus": "string"
                            },
                            "contactDetails": {
                                "contactName": "string"
                            },
                            "countryOfResidence": "string",
                            "formerNames": [
                                {
                                    "forenames": "string",
                                    "surname": "string"
                                }
                            ],
                            "identification": {
                                "identificationType": "string",
                                "legalAuthority": "string",
                                "legalForm": "string",
                                "placeRegistered": "string",
                                "registrationNumber": "string"
                            },
                            "isPre1992Appointment": "boolean",
                            "links": {
                                "company": "string"
                            },
                            "name": "string",
                            "nameElements": {
                                "forename": "string",
                                "honours": "string",
                                "otherForenames": "string",
                                "surname": "string",
                                "title": "string"
                            },
                            "nationality": "string",
                            "occupation": "string",
                            "officerRole": "string",
                            "principalOfficeAddress": {
                                "addressLine1": "string",
                                "addressLine2": "string",
                                "careOf": "string",
                                "country": "string",
                                "locality": "string",
                                "poBox": "string",
                                "postalCode": "string",
                                "premises": "string",
                                "region": "string"
                            },
                            "resignedOn": "date",
                            "responsibilities": "string"
                        }
                    ],
                    "itemsPerPage": "integer",
                    "kind": "string",
                    "links": {
                        "self": "string"
                    },
                    "name": "string",
                    "startIndex": "integer",
                    "totalResults": "integer"
                }
            ],
            "naturalOfficerDisqualifications": [
                {
                    "dateOfBirth": "date",
                    "disqualifications": [
                        {
                            "address": {
                                "addressLine1": "string",
                                "addressLine2": "string",
                                "country": "string",
                                "locality": "string",
                                "postalCode": "string",
                                "premises": "string",
                                "region": "string"
                            },
                            "caseIdentifier": "string",
                            "companyNames": [
                                "string"
                            ],
                            "courtName": "string",
                            "disqualificationType": "string",
                            "disqualifiedFrom": "date",
                            "disqualifiedUntil": "date",
                            "heardOn": "date",
                            "lastVariation": [
                                {
                                    "caseIdentifier": "string",
                                    "courtName": "string",
                                    "variedOn": "date"
                                }
                            ],
                            "reason": {
                                "act": "string",
                                "article": "string",
                                "descriptionIdentifier": "string",
                                "section": "string"
                            },
                            "undertakenOn": "date"
                        }
                    ],
                    "etag": "string",
                    "forename": "string",
                    "honours": "string",
                    "kind": "string",
                    "links": {
                        "self": "string"
                    },
                    "nationality": "string",
                    "otherForenames": "string",
                    "permissionsToAct": [
                        {
                            "companyNames": [
                                "string"
                            ],
                            "courtName": "string",
                            "expiresOn": "date",
                            "grantedOn": "date"
                        }
                    ],
                    "surname": "string",
                    "title": "string"
                }
            ],
            "corporateOfficerDisqualifications": [
                {
                    "companyNumber": "string",
                    "countryOfRegistration": "string",
                    "disqualifications": [
                        {
                            "address": {
                                "addressLine1": "string",
                                "addressLine2": "string",
                                "country": "string",
                                "locality": "string",
                                "postalCode": "string",
                                "premises": "string",
                                "region": "string"
                            },
                            "caseIdentifier": "string",
                            "companyNames": [
                                "string"
                            ],
                            "courtName": "string",
                            "disqualificationType": "string",
                            "disqualifiedFrom": "date",
                            "disqualifiedUntil": "date",
                            "heardOn": "date",
                            "lastVariation": [
                                {
                                    "caseIdentifier": "string",
                                    "courtName": "string",
                                    "variedOn": "date"
                                }
                            ],
                            "reason": {
                                "act": "string",
                                "article": "string",
                                "descriptionIdentifier": "string",
                                "section": "string"
                            },
                            "undertakenOn": "date"
                        }
                    ],
                    "etag": "string",
                    "kind": "string",
                    "links": {
                        "self": "string"
                    },
                    "name": "string",
                    "permissionsToAct": [
                        {
                            "companyNames": [
                                "string"
                            ],
                            "courtName": "string",
                            "expiresOn": "date",
                            "grantedOn": "date"
                        }
                    ]
                }
            ]
        }
    ],
    "kind": "response",
    "links": {
        "self": "https://example.com/officers"
    },
    "resignedCount": 20,
    "itemsPerPage": 50,
    "startIndex": 0,
    "totalResults": 120
}