Company due diligence

Company Due Diligence API

Put the public-record evidence for a UK company in one response your review process can retain, compare, and explain.

What it makes possible

A public-record check that keeps its provenance

Due diligence often begins with a company profile and spreads into officers, ownership, charge history, and insolvency. The published entity schema keeps those source-specific slabs in one normalised response while preserving which upstream records were available for that request.

Create a repeatable case record

Fetch the entity profile by company number and retain the returned fetched_at timestamps with the result. Each slab is present as structured data rather than requiring an analyst or agent to interpret a rendered register page.

Follow the questions that matter

Check the Companies House profile and PSC data, then review officers, charges, and insolvency cases in the same object. A complete list is not guaranteed when a source indicates truncation, so that state belongs in the case record too.

Escalate uncertainty explicitly

Use sources_failed for an unavailable registry, unknown for tri-state source results, and the risk response's indeterminate flags where a score could not assess a required source. Those states are inputs to review, not conclusions.

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.

registered_office_address and SIC codes: Company profile facts that help establish the recorded entity and its declared activity.
persons and officers.items: PSC and officer records, including active status, appointment information, and director-focused derived views.
charges.items: Charge status, dates, persons entitled, and structured floating-charge information where Companies House supplied it.
sources_checked and sources_failed: A compact audit trail of the sources attempted and the subset that failed for this request.

Interpretation

Use the status fields before the records

For charges and officers, none means a confirmed absence only when the relevant source was successfully checked. unknown means the source was not requested or could not be fetched. If a list is marked truncated, it is shorter than the upstream total and cannot be treated as a complete history.

Review prompts

What does the public company record say about status, filings, and activity?
Who is recorded as controlling or directing the company?
Is a charge or insolvency record relevant to the review?
Which record groups need a retry or a human follow-up before the case can close?

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: enrich UK companies in a repeatable workflow