uk-company-data

Look up a UK company by company number. Returns register details, latest financials (iXBRL figures as filed at Companies House and/or AI-extracted estimates from PDF accounts), risk signals and trajectory. Note: 'Total assets less current liabilities' and 'Creditors' are reported as filed; dates are balance sheet dates.

{
  "type": "object",
  "properties": {
    "company_number": {
      "type": "string",
      "description": "Companies House number, e.g. '12345678'"
    }
  },
  "required": [
    "company_number"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Search UK companies by financial criteria. Returns up to 50 matches.

{
  "type": "object",
  "properties": {
    "risk_band": {
      "description": "Filter by risk band",
      "type": "string",
      "enum": [
        "clean",
        "low",
        "medium",
        "high"
      ]
    },
    "trajectory": {
      "description": "Filter by trajectory",
      "type": "string",
      "enum": [
        "improving",
        "stable",
        "deteriorating"
      ]
    },
    "size_class": {
      "description": "Filter by size",
      "type": "string",
      "enum": [
        "micro",
        "small",
        "medium",
        "large"
      ]
    },
    "min_total_assets": {
      "description": "Minimum total assets less current liabilities, in GBP",
      "type": "number"
    },
    "max_total_assets": {
      "description": "Maximum total assets less current liabilities, in GBP",
      "type": "number"
    },
    "min_employees": {
      "description": "Minimum number of employees",
      "type": "number"
    },
    "negative_net_assets": {
      "description": "Filter for negative net assets",
      "type": "boolean"
    },
    "insolvency_proxy": {
      "description": "Filter for insolvency proxy flag",
      "type": "boolean"
    },
    "sort_by": {
      "description": "Sort field",
      "type": "string",
      "enum": [
        "total_assets",
        "net_assets",
        "cash",
        "risk_score",
        "num_employees"
      ]
    },
    "sort_order": {
      "description": "Sort direction",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "limit": {
      "description": "Max results (default 20)",
      "type": "number",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Compare two UK companies side by side.

{
  "type": "object",
  "properties": {
    "company_a": {
      "type": "string",
      "description": "First company number"
    },
    "company_b": {
      "type": "string",
      "description": "Second company number"
    }
  },
  "required": [
    "company_a",
    "company_b"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get aggregate market statistics across all companies in the database.

{
  "type": "object",
  "properties": {
    "group_by": {
      "description": "Group results by field",
      "type": "string",
      "enum": [
        "risk_band",
        "size_class",
        "trajectory"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Find companies matching specific financial triggers useful for B2B lead generation.

{
  "type": "object",
  "properties": {
    "trigger": {
      "type": "string",
      "enum": [
        "rapid_growth",
        "cash_rich",
        "distressed",
        "new_investment",
        "deteriorating",
        "improving",
        "large_employer"
      ],
      "description": "Type of trigger to search for"
    },
    "limit": {
      "description": "Max results (default 20)",
      "type": "number",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "trigger"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Search all UK companies (Companies House register, ~5.6M) by name. Ranking: exact name match (ignoring LTD/LIMITED/PLC etc.) first, then active companies, then names starting with or containing the phrase, then other matches (words match as prefixes). Returns company numbers for lookup_company.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name or partial name to search for"
    },
    "limit": {
      "description": "Max results (default 20)",
      "type": "number",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "name"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List companies whose iXBRL accounts were published at Companies House in the last N days (by publication date; each row also shows the balance sheet date). Useful for monitoring a watchlist or finding fresh signal.

{
  "type": "object",
  "properties": {
    "days": {
      "description": "Look-back window in days (default 30)",
      "type": "number",
      "minimum": 1,
      "maximum": 365
    },
    "limit": {
      "description": "Max results (default 30)",
      "type": "number",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Add UK companies (by company number) to your monitoring watchlist. The current Companies House state is snapshotted; get_alerts then reports status changes, overdue accounts, new accounts, new charges and financial deterioration. Watchlist size: 5 companies on Free, 50 on Pro.

{
  "type": "object",
  "properties": {
    "company_numbers": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Companies House numbers, e.g. ['00445790', 'SC123456']"
    }
  },
  "required": [
    "company_numbers"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Remove companies from your monitoring watchlist.

{
  "type": "object",
  "properties": {
    "company_numbers": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Companies House numbers to stop watching"
    }
  },
  "required": [
    "company_numbers"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Show your monitoring watchlist with each company's current status, accounts due date and latest balance sheet date.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Monitoring alerts for your watchlist: status changes (liquidation, administration, strike-off), overdue accounts, newly registered or published accounts, new charges, negative net assets, and drops of 30%+ in net assets or cash between the last two iXBRL accounts. Sorted by severity.

{
  "type": "object",
  "properties": {
    "since": {
      "description": "Report published accounts since this date (YYYY-MM-DD). Default: 30 days ago.",
      "type": "string"
    },
    "severity": {
      "description": "Minimum severity to return (default info = all)",
      "type": "string",
      "enum": [
        "high",
        "medium",
        "info"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}