Find an officer
find_officerRead-onlyIdempotent
Search Companies House by officer name to find directors, secretaries, or LLP members. Returns candidate officer IDs with appointment counts to identify the right person and get their appointments.
Instructions
Search Companies House for a company officer — a director, secretary or LLP member — by name. Returns candidate officer IDs with how many appointments each holds. Use it when you have a person and want the companies they are involved in; feed the officer_id to get_officer_appointments. Officer records are per-appointment-identity rather than per-person, so a common name returns many candidates and the appointment count and date of birth are usually what separates them.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | The officer's name. | |
| verbose | No | Also return the untouched Companies House payload under `raw`, alongside the shaped result. Roughly two and a half times the size; use it only when a field you need is missing from the shaped result. | |
| start_index | No | Zero-based offset into the full result set. Use pagination.has_more to decide. | |
| items_per_page | No | How many records to return. Defaults to the API default; the maximum is 100. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| raw | No | The untouched Companies House payload. Present only when verbose was true. | |
| meta | Yes | Provenance and budget for this answer. | |
| query | Yes | ||
| officers | Yes | ||
| pagination | Yes | Where this page sits in the full result set. |