Compliance

Director & PSC identity verification status (ECCTA)

Every officer and PSC with their Companies House identity verification dates and a status: verified (a verification statement for the role is on the register and has not ended), overdue, due_soon, pending, not_yet_scheduled (no date shown or worked out), ended (the statement was removed and no new date is shown) or not_applicable. deadline_basis says whether a date is the one Companies House shows (companies_house) or was worked out from the rules (derived_confirmation_statement, derived_birth_month, derived_psc_director). The 12-month transition for existing directors and PSCs runs from 18 November 2025; their due dates follow the confirmation statement or birth month, so some run to 30 November or 1 December 2026. status "verified" follows the register: a statement supplied on or before today whose end date (9999-12-31 while live) has not passed. Data is read from Companies House and cached for 24 hours (refresh=true forces a refresh).

get/compliance/identity/{number}

Request

  • Base URL: https://api.companystack.co.uk
  • URL: https://api.companystack.co.uk/compliance/identity/{number}
  • Auth: one of:
    • HTTP bearer
    • API key in header X-Api-Key

Path parameters

numberstring required

Query parameters

refreshboolean

true reads Companies House again. Honoured once per company every 15 minutes; within that time the stored answer is returned. The response's refresh field says done, or skipped with the reason.

Response

Status per person and summary

Changes

No recorded changes to this operation across all 1 revision of this API.