API reference · version 1.0.0

UK Business Risk + Director Score

Per-company risk score (0-100) and director credentials, live from Companies House, insolvency records included.

Base address

https://api.stratumapis.com/v1/business-risk

Your key

The X-Stratum-Key header, with the key from your API page. Paid per call from your API balance, with no plan (add money on your API page).

Prices

A company’s score49p (25p from 1,000 a month)
A bulk requestEach company scored or found not to exist; one Companies House couldn’t read is free

Every reply carries X-Stratum-Credit-Balance-Pence; a refusal or a source failure is never charged. Limits and prices.

OpenAPI

Download the OpenAPI file (JSON)

Endpoints

gethttps://api.stratumapis.com/v1/business-risk/score/{number}

Risk score + factor breakdown for a single company

Reads the company from Companies House (a company read in the last hour is answered from that read) and scores it 0-100 (higher is safer) with a band A-F. Every point taken off is listed in factors with a stable code. Counts as one lookup; a 404 (no such company) and a 503 (Companies House could not be read) are not counted.

Parameters

numberrequiredin path · Companies House number (digits will be left-padded; SC/NI/OC prefixes preserved)

Example request

curl -H "X-Stratum-Key: $STRATUM_KEY" \
  "https://api.stratumapis.com/v1/business-risk/score/00445790"

Example reply: An active plc (Tesco PLC)

{
  "companyNumber": "00445790",
  "companyName": "TESCO PLC",
  "score": 92,
  "band": "A",
  "factors": [
    {
      "code": "high_officer_churn",
      "label": "High officer churn",
      "weight": 8,
      "detail": "63 resigned vs 11 active."
    }
  ],
  "company": {
    "companyNumber": "00445790",
    "companyStatus": "active",
    "type": "plc",
    "dateOfCreation": "1947-11-27",
    "hasCharges": false,
    "accounts": {
      "nextAccountsDue": "2027-08-26",
      "overdue": false
    },
    "officers": {
      "activeCount": 11,
      "resignedCount": 63
    }
  },
  "scoredAt": "2026-10-21T21:00:00.000Z"
}

Example reply: A dissolved company

{
  "companyNumber": "13571234",
  "companyName": "BURWARDSLEY LTD",
  "score": 0,
  "band": "F",
  "factors": [
    {
      "code": "status_dissolved",
      "label": "Company is dissolved",
      "weight": 90,
      "detail": "Companies House lists this entity as dissolved."
    },
    {
      "code": "no_active_officers",
      "label": "No active officers",
      "weight": 25,
      "detail": "Companies must legally have at least one director."
    }
  ],
  "company": {
    "companyNumber": "13571234",
    "companyStatus": "dissolved",
    "type": "ltd",
    "dateOfCreation": "2021-08-17"
  },
  "scoredAt": "2026-10-21T21:00:00.000Z"
}

Errors

401 Missing or invalid API key
404 No such company
503 Companies House could not be read just now (error code companies_house_unavailable) or is not configured. Not charged; try again shortly.

posthttps://api.stratumapis.com/v1/business-risk/bulk

Score up to 50 companies in one call

Results come back in the order sent. Each company looked up counts as one lookup, including a number with no company (found: false); a company Companies House could not be read for (found: null) is not counted.

Example request

curl -X POST -H "X-Stratum-Key: $STRATUM_KEY" \
  -H "Content-Type: application/json" \
  -d '{"numbers":["00445790","13571234"]}' \
  "https://api.stratumapis.com/v1/business-risk/bulk"