SStratum APIs

UK Companies House Real-Time Watch

API reference

Authentication

All requests require an X-Stratum-Key header. Get a key by subscribing to a plan.

Base URL
https://api.stratumapis.com/v1/ch

Endpoints

gethttps://api.stratumapis.com/v1/ch/companies/{number}

Single company lookup, cached

Parameters
  • numberrequiredin pathCompanies House number (eight chars; SC, NI, OC prefixes preserved; bare digits left-padded to eight)
Example
curl -H "X-Stratum-Key: $KEY" \
  https://api.stratumapis.com/v1/ch/companies/:number
gethttps://api.stratumapis.com/v1/ch/companies/{number}/psc-tree

PSC tree + UBO computation (B-CH-2)

Parameters
  • numberrequiredin pathCompanies House number of the corporate landlord / customer
  • depthin queryMaximum recursion depth. Defaults to 5 hops.
Example
curl -H "X-Stratum-Key: $KEY" \
  https://api.stratumapis.com/v1/ch/companies/:number/psc-tree
gethttps://api.stratumapis.com/v1/ch/monitored

List monitored Companies House numbers for this API key

Example
curl -H "X-Stratum-Key: $KEY" \
  https://api.stratumapis.com/v1/ch/monitored
puthttps://api.stratumapis.com/v1/ch/monitored

Replace the full set of monitored Companies House numbers

Example
curl -H "X-Stratum-Key: $KEY" \
  https://api.stratumapis.com/v1/ch/monitored
deletehttps://api.stratumapis.com/v1/ch/monitored/{number}

Remove a single Companies House number from the monitored set

Parameters
  • numberrequiredin path
Example
curl -H "X-Stratum-Key: $KEY" \
  https://api.stratumapis.com/v1/ch/monitored/:number
gethttps://api.stratumapis.com/v1/ch/changes

Changes feed for monitored companies since a given date

Parameters
  • sincerequiredin queryLower bound (YYYY-MM-DD). Capped at the tier history window (Starter 14d, Growth 90d, Pro 365d).
  • limitin query
Example
curl -H "X-Stratum-Key: $KEY" \
  https://api.stratumapis.com/v1/ch/changes
gethttps://api.stratumapis.com/v1/ch/companies/{number}/psc-velocity

PSC ownership-velocity flag (W30 iter 3)

Parameters
  • numberrequiredin pathCompanies House number
Example
curl -H "X-Stratum-Key: $KEY" \
  https://api.stratumapis.com/v1/ch/companies/:number/psc-velocity