/person

GET 1 request = 1 credit

Coverage All officers recorded at Companies House across the UK.

Returns a resolved individual and every directorship they hold or have held, along with companies related through shared directors and PSCs. Identity is resolved across name variants, so "Priya Raman" and "Priya A Raman" collapse to one person rather than two.

Input

Parameter	Description	Required
`key`	Your API key. May also be sent as a bearer token or X-API-Key header.	Required
`person_number_short`	Stable person ID, as returned by /officers.	Required
`include_resigned`	true to include resigned appointments. Default true.	Optional

Example request

GET request

https://api.ukdatalayer.com/v1/person?key=YOUR_KEY&person_number_short=900000123

Output

Field	Type	Description
`person_number_short`	string	Stable person identifier.
`name`	string	Resolved person name.
`date_of_birth`	string \| null	Month precision (YYYY-MM).
`nationality`	string \| null	Declared nationality.
`country_of_residence`	string \| null	Declared country of residence.
`is_sanctioned`	boolean \| null	Sanctions flag where recorded. Null where not captured.
`former_names`	string[]	Previously filed name variants.
`appointments[]`	object[]	Each with company_id, company_number, company_name, company_status, officer_role, appointed_on and resigned_on.
`total_appointments`	number	Number of appointments after the include_resigned filter.
`related_companies[]`	object[]	Companies linked by shared directors or PSCs, with related_company_id, related_company_name, shared_director_count, shared_psc_count and total_links.

Example response

200 OK · application/json

{
  "status": "success",
  "credits_used": 1,
  "data": {
    "person_number_short": "900000123",
    "name": "Priya Raman",
    "date_of_birth": "1984-03",
    "nationality": "British",
    "country_of_residence": "England",
    "former_names": [],
    "appointments": [
      {
        "company_id": "UK-00000042",
        "company_name": "NORTHGATE ANALYTICS LTD",
        "officer_role": "director",
        "appointed_on": "2016-05-11",
        "resigned_on": null
      },
      {
        "company_id": "UK-00000041",
        "company_name": "NORTHGATE GROUP HOLDINGS LTD",
        "officer_role": "director",
        "appointed_on": "2022-09-30",
        "resigned_on": null
      }
    ],
    "total_appointments": 2
  }
}

Notes

Because dates of birth are month-precision, two different people sharing a name and birth month cannot always be separated. Matches are graded by confidence and only high-confidence resolutions are returned.