/officers

GET 1 request = 1 credit

Coverage All UK jurisdictions. Includes corporate officers and nominee appointments, flagged as such.

Returns every officer appointment recorded against a company, with role, appointment and resignation dates, occupation, nationality and a stable person identifier you can use to pivot to that person’s other directorships.

Input

Parameter	Description	Required
`key`	Your API key. May also be sent as a bearer token or X-API-Key header.	Required
`company_number`	Companies House company number, with or without the UK- prefix. E.g. 00000042 or UK-00000042.	Required
`status`	active to return only serving officers, resigned for former officers, all for both. Default active.	Optional

Example request

GET request

https://api.ukdatalayer.com/v1/officers?key=YOUR_KEY&company_number=00000042&status=active

Output

Field	Type	Description
`officers[].person_number_short`	string	Stable person ID. Use with /person to fetch all their appointments.
`officers[].name`	string	Officer name as filed.
`officers[].officer_role`	string	director, secretary, llp-member, corporate-nominee-director and similar.
`officers[].occupation`	string \| null	Occupation as declared.
`officers[].nationality`	string \| null	Declared nationality.
`officers[].date_of_birth`	string \| null	Month precision only (YYYY-MM), as published by Companies House.
`officers[].appointed_on`	date	Appointment date.
`officers[].resigned_on`	date \| null	Resignation date, null if serving.
`officers[].country_of_residence`	string \| null	Declared country of residence.
`officers[].officer_is_company`	boolean	True for corporate officers.
`total`	number	Number of officers matching the status filter.

Example response

200 OK · application/json

{
  "status": "success",
  "credits_used": 1,
  "data": {
    "company_number": "00000042",
    "officers": [
      {
        "person_number_short": "900000123",
        "name": "Priya Raman",
        "officer_role": "director",
        "occupation": "Chief Executive",
        "nationality": "British",
        "date_of_birth": "1984-03",
        "appointed_on": "2016-05-11",
        "resigned_on": null,
        "officer_is_company": false
      },
      {
        "person_number_short": "900000124",
        "name": "Daniel Okoro",
        "officer_role": "director",
        "occupation": "Chief Technology Officer",
        "nationality": "British",
        "date_of_birth": "1987-11",
        "appointed_on": "2016-05-11",
        "resigned_on": null,
        "officer_is_company": false
      }
    ],
    "total": 2
  }
}

Notes

Date of birth is published to month precision only. There is no day component available for any officer.
Formation-agent nominees typically appear at incorporation and resign within days. Filter on officer_is_company and the nominee roles if you need genuine controllers.