Return the filing history of a UK company from the Companies House register — accounts, co
Return the filing history of a UK company from the Companies House register — accounts, confirmation statements, officer appointments, address and capital changes, resolutions and mortgages — most recent first, optionally filtered by category, with date, form type (AA, CS01, AP01, TM01), the readable register description, registrar annotations and a document_url for every filed image. Use when: What has this UK company filed recently?
5000 (raw units)
price
3
calls / 30d
2
unique payers
2026-08-27
updated
Provider
api.eckari.com · discovered, not yet claimed by its owner
Payment (x402 accepts[])
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0x9d6b6fdB04040a55d58B24ff4C90C08cf6083C8f",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "5000",
"maxTimeoutSeconds": 60
}
]Output schema
{
"bazaar": {
"info": {
"input": {
"method": "GET",
"pathParams": {
"company_number": "00445790"
},
"queryParams": {
"limit": 3
},
"type": "http"
},
"output": {
"example": {
"data": {
"company_number": "00445790",
"filing_history_status": "filing-history-available",
"is_filing_history_available": true,
"items": [
{
"annotations": [
{
"annotation": "Clarification HMRC confirmation received that appropriate Stamp Duty has been paid for this transaction.",
"date": "2026-08-06",
"description": "annotation"
}
],
"category": "capital",
"date": "2026-08-06",
"description": "Purchase of own shares.",
"description_source": "enumeration",
"document_url": "https://find-and-update.company-information.service.gov.uk/company/00445790/filing-history/MzUzNjI5NTk0OWFkaXF6a2N4/document?format=pdf",
"has_document": true,
"pages": 4,
"paper_filed": true,
"subcategory": null,
"transaction_id": "MzUzNjI5NTk0OWFkaXF6a2N4",
"type": "SH03"
},
{
"annotations": [
{
"annotation": "Clarification HMRC confirmation received that appropriate Stamp Duty has been paid for this transaction.",
"date": "2026-08-06",
"description": "annotation"
}
],
"category": "capital",
"date": "2026-08-06",
"description": "Purchase of own shares.",
"description_source": "enumeration",
"document_url": "https://find-and-update.company-information.service.gov.uk/company/00445790/filing-history/MzUzNjI5NTk1OWFkaXF6a2N4/document?format=pdf",
"has_document": true,
"pages": 4,
"paper_filed": true,
"subcategory": null,
"transaction_id": "MzUzNjI5NTk1OWFkaXF6a2N4",
"type": "SH03"
},
{
"annotations": [
{
"annotation": "Clarification HMRC confirmation received that appropriate Stamp Duty has been paid for this transaction.",
"date": "2026-08-06",
"description": "annotation"
}
],
"category": "capital",
"date": "2026-08-06",
"description": "Purchase of own shares.",
"description_source": "enumeration",
"document_url": "https://find-and-update.company-information.service.gov.uk/company/00445790/filing-history/MzUzNjI5NTk3MWFkaXF6a2N4/document?format=pdf",
"has_document": true,
"pages": 4,
"paper_filed": true,
"subcategory": null,
"transaction_id": "MzUzNjI5NTk3MWFkaXF6a2N4",
"type": "SH03"
}
],
"page": {
"has_more": true,
"limit": 3,
"next_offset": 3,
"offset": 0,
"returned": 3,
"total": 8367
},
"query": {
"category": null,
"detail": "summary"
}
},
"meta": {
"capability": "company.uk.filings",
"freshness": "live",
"source": "companies_house",
"version": "3.0.0"
}
},
"type": "json"
}
},
"routeTemplate": "/v1/companies/uk/:company_number/filings",
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET",
"HEAD",
"DELETE"
],
"type": "string"
},
"pathParams": {
"additionalProperties": false,
"properties": {
"company_number": {
"description": "Companies House company number. Accepted shapes are the register's own — 1-8 digits (zero-padded to 8, e.g. 445790 → 00445790), one letter + 7 digits (R0000001), two letters + 6 digits (SC002180, NI000001, OC123456, OE000001), or the registered-society suffix forms (two letters + 5 digits + 1 letter; two letters + 4 digits + 2 letters). Case-insensitive; surrounding whitespace is ignored (which is why maxLength is 10); internal spaces and punctuation are not accepted. Any other value (for example PROBE) is rejected as INVALID_INPUT before payment and before any upstream call.",
"maxLength": 10,
"minLength": 1,
"pattern": "^\\s*(?:[0-9]{1,8}|[A-Za-z][0-9]{7}|[A-Za-z]{2}[0-9]{6}|[A-Za-z]{2}[0-9]{5}[A-Za-z]|[A-Za-z]{2}[0-9]{4}[A-Za-z]{2})\\s*$",
"type": "string"
}
},
"required": [
"company_number"
],
"type": "object"
},
"queryParams": {
"additionalProperties": false,
"properties": {
"category": {
"description": "Optional comma-separated register categories to include (e.g. accounts, address, annual-return, capital, change-of-name, incorporation, liquidation, miscellaneous, mortgage, officers, resolution, confirmation-statement). The applied value is echoed back as query.category.",
"maxLength": 200,
"pattern": "^[a-z-]+(,[a-z-]+)*$",
"type": "string"
},
"detail": {
"description": "How much of each filing to return. Default summary: the readable description, its source, the register's annotations, the form type and the document URL. `full` adds the register's raw description_key and description_values for reconciliation against a register capture.",
"enum": [
"summary",
"full"
],
"type": "string"
},
"limit": {
"description": "Maximum filings to return per page (1-100). Default 5.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"offset": {
"description": "Zero-based index into the register's filing list for the applied category filter. Nothing is filtered out after reading, so page.has_more is simply offset + returned < page.total; pass back page.next_offset.",
"maximum": 10000,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}
},
"payment-identifier": {
"info": {
"required": false
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"maxLength": 128,
"minLength": 16,
"pattern": "^[a-zA-Z0-9_-]+$",
"type": "string"
},
"required": {
"type": "boolean"
}
},
"required": [
"required"
],
"type": "object"
}
}
}Use it
curl
curl "https://api.eckari.com/v1/companies/uk/:company_number/filings" # -> 402 Payment Required, accepts[] lists how to pay # retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://api.eckari.com/v1/companies/uk/:company_number/filings");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://api.eckari.com/v1/companies/uk/:company_number/filings")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerMachine-readable
Everything on this page is also available as clean JSON at /resources/4311.json, and this resource appears in /discovery/resources and /discovery/search.