> For the complete documentation index, see [llms.txt](https://docs.transactionlink.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.transactionlink.io/docs/v1/integrations/companies-house/public-data-api/officers.md). # Officers ### Output | Attribute | Type | Description | | ----------------------- | -------------- | ---------------------------------------------------------------------- | | activeCount | integer | The count of active officers. | | etag | string | The ETag of the resource. | | [items](#officer-item) | array\ | The list of officers. | | [links](#officers-link) | object | Links to other resources associated with this officer list resource. | | kind | string |

Possible values are:

| | resignedCount | number | The number of resigned officers in this result set. | | totalResults | number | The total number of officers in this result set. | ### Officer Item
AttributeTypeDescription
addressobjectThe correspondence address of the officer.
appointedBeforedateThe date before which the officer was appointed.
appointedOndateThe date on which the officer was appointed.
contactDetailsobjectThe contact name for the officer.
countryOfResidencestringThe country of residence of the officer.
dateOfBirthobjectThe day of birth of the officer.
etagstringThe ETag of the officer's resource.
formerNamesobjectThe former forenames of the officer.
identificationobjectThe type of identification for the officer.
isPre1992AppointmentbooleanFlag indicating if the appointment was made before 1992.
linksobjectLinks to other resources associated with this officer list item.
namestringThe name of the officer.
nationalitystringThe nationality of the officer.
occupationstringThe occupation of the officer.
officerRolestringThe role of the officer.
principalOfficeAddressobjectThe principal/registered office address.
resignedOndateThe date on which the officer resigned.
responsibilitiesstringThe responsibilities of the officer.
appointmentsarray<object>Officer appointment list.
naturalOfficerDisqualificationsarray<object>Natural officers disqualifications. Only present is of natural type.
corporateOfficerDisqualificationsarray<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](#appointment-date-of-birth) | 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](#appointment-item) | array\ | Array of appointed officer's appointments. | | [links](#appointment-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
AttributeTypeDescription
monthnumberMonth of birth of the appointed officer.
yearnumberYear 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](#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](#appointed-to) |


object

|

The company information of the appointment.

| | [contactDetails](#contact-details) | object |

The contact at the corporate-managing-officer of a registered-overseas-entity.

| | countryOfResidence | string | The officer's country of residence. | | [formerNames](#former-names) | array\ | Former names for the officer, if there are any. | | [identification](#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](#appointment-item-links) | object | Links to other resources associated with this officer appointment item. | | name | string | The full name of the office. | | [nameElements](#name-elements) | 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](#principal-office-address) | 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](#officer-disqualification) | 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](#officer-disqualifications-links) | object | Links to other resources associated with this officer disqualification resource. | | name | string | Name of the disqualified officer. | | [permissionsToAct](#permissions-to-act) | array\ | 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](#officer-disqualification) | array\ | 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](#officer-disqualifications-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](#permissions-to-act) | 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](#address) | object | Address of the disqualified officer as provided by the disqualifying authority. | | caseIdentifier | string | Case identifier of the disqualification. | | companyNames | array\ | 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](#last-variation) | array\ | Latest variation made to the disqualification. | | [reason](#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\ | 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 } ```