Director records and current API scope
Director Disqualification Checks: API Scope
Use the published director records for a UK company, while keeping the boundary of the current disqualification-checking schema explicit.
What it makes possible
A public-record check that keeps its provenance
The published entity schema exposes active officers and a derived directors array, with an option to include resigned officers. It does not currently declare a per-director disqualification verdict, a disqualification-check roll-up, or a director-disqualification risk flag. A workflow must not treat that omission as a clearance.
01
Read the active officer set
The entity response returns active officers by default and a derived director view. Request include_resigned=true when the use case needs resigned appointments as well; full active and resigned counts remain available either way.
02
Keep a schema boundary in the decision
The current public contract lists director identifiers, names, and appointment dates, but no clear, disqualified, or unknown field. Do not derive a disqualification clearance from a name, an absent field, or a non-matching officer record.
03
Escalate a disqualification check separately
If a workflow requires a director disqualification result, obtain it from a source that exposes a documented verdict or wait for a published Rotuli contract that declares one. The API's current director data can still identify the officer record that needs review.
Response surface
Fields to put in the workflow
The response uses named slabs, stable enum values, and null or empty values instead of silently omitting fields.
- officers.items[]
- Published officer identity, role, appointment, resignation, and related Companies House record fields.
- officers.directors[]
- A derived view limited to the four director role variants, de-duplicated only where the Companies House officer identifier is the same.
- officers.status
- none, present, or unknown. unknown means the officer source was not requested or could not be fetched.
- include_resigned
- A query option that adds resigned officers to items; total, active, and resigned counts still cover the full officer set.
Interpretation
A missing verdict is not a negative result
The current OpenAPI document has no documented disqualification result to interpret. A name can belong to more than one person, and a profile that contains no disqualification field cannot establish that a director is clear. Keep the additional check outside this response until the public contract explicitly represents it.
Review prompts
- Which active officers and director records are returned for this company?
- Does this workflow require a documented disqualification verdict before it can close?
- Has a source supplied an explicit result, rather than an absent field or name-only inference?
- Does the officer source need a retry because its status is unknown or its list is truncated?
First request
Start with a company number
curl "https://api.rotuli.co.uk/v1/entity/00445790" \
-H "Authorization: Bearer uk_live_YOUR_KEY"The Free tier includes 500 requests per month with no card required. See the API reference for the full response schema and data sources for licence and freshness details.
Guide: connect an agent to Rotuli with MCP and OAuth