Resolve402 / services

UK company accounts (Companies House iXBRL)

GET /api/uk-company-accounts · $0.01 per call (USDC on Base or Solana, x402)

Get the figures of the latest annual accounts a UK company filed at Companies House: net assets, equity, cash, current and fixed assets, creditors due within and after one year, average employees, and turnover and profit when published, for the year and the prior year. Give a Companies House number or a company name. The latest AA filing is read from the iXBRL document itself (FRS 102, FRS 105, FRS 101 or IFRS taxonomies, any filing software), with the period, framework, currency, consolidated or company basis and the concept behind each figure. null = the line is not tagged in these accounts. Charged only if figures are found.

Problem solved

You need the balance sheet of a UK private company (most file abridged or micro-entity accounts) as data, and reading it yourself means finding the right filing, downloading the iXBRL, resolving filing-software prefixes, contexts, dimensions, scale and sign.

Use cases

Input

GET /api/uk-company-accounts?company_number=<Companies House number, e.g. 04962788 or SC360429> | ?company=<name>

ParameterWhereTypeDescription
company_numberquerystringCompanies House number: 8 digits (zero-padded, 6-7 digits accepted) or 2 letters + 6 digits (SC, NI, OC...). Preferred over company.
companyquerystringCompany name, e.g. Plumbing Advisory Contracts (used when no company_number; the active company with that exact name, else the first active match)

Output

company {company_number, name}, filing {type, description, made_up_to, filed_on, document_url (iXBRL), pdf_url}, standard (FRS 105, FRS 102 Section 1A, FRS 102, FRS 101, IFRS...), basis (company, consolidated or mixed), currency, dormant, period {start, end}, prior_period, current and prior {turnover, profit_loss, net_assets, equity, cash, current_assets, fixed_assets, creditors_within_one_year, creditors_after_one_year, average_employees} in full units (creditors positive), provenance {field: {concept, context, basis, dims, sign, derived_from}}, resolution, meta {source, licence, notes}. null = not tagged in the filing. 404 = nothing readable, not charged.

Price

$0.01 per call. Charged only if figures are found: 404 not_found, no_accounts and no_ixbrl_accounts (latest accounts filed on paper or as PDF only), 400 invalid input and 502 source_unavailable are not charged.

Example

GET https://resolve402.dev/api/uk-company-accounts?company_number=04962788
{
  "company": {
    "company_number": "04962788",
    "name": "PLUMBING ADVISORY CONTRACTS LIMITED"
  },
  "filing": {
    "type": "AA",
    "description": "Total exemption full accounts made up to 30 November 2025",
    "made_up_to": "2025-11-30",
    "filed_on": "2026-08-25",
    "document_url": "https://find-and-update.company-information.service.gov.uk/company/04962788/filing-history/MzU0MDc5MTQ1N2FkaXF6a2N4/document?format=xhtml&download=1"
  },
  "standard": "FRS 102 Section 1A",
  "basis": "company",
  "currency": "GBP",
  "dormant": false,
  "period": {
    "start": "2024-12-01",
    "end": "2025-11-30"
  },
  "prior_period": {
    "start": "2023-12-01",
    "end": "2024-11-30"
  },
  "current": {
    "turnover": null,
    "profit_loss": null,
    "net_assets": 45130,
    "equity": 45130,
    "cash": 110236,
    "current_assets": 117560,
    "fixed_assets": 24273,
    "creditors_within_one_year": 96703,
    "creditors_after_one_year": null,
    "average_employees": 2
  },
  "prior": {
    "net_assets": 43023,
    "cash": 100144,
    "current_assets": 123298,
    "creditors_within_one_year": 100743,
    "average_employees": 2
  },
  "provenance": {
    "net_assets": {
      "concept": "core:NetAssetsLiabilities",
      "context": "PE_DIM156",
      "basis": "company"
    }
  }
}

Real output of lib/ukaccounts.ts on 2026-10-26 against the Companies House public register (abridged: pdf_url, prior fields, provenance and meta shortened).

Sources

Limits

Use it

All services