# Eckari UK Companies House Filing History API > Eckari UK Companies House Filing History API is a paid API for AI agents from api.eckari.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-07). Retrieves paginated filing history for a UK company from Companies House, including document URLs, form types, categories, and annotations. ## Facts - Endpoint: GET https://api.eckari.com/v1/companies/uk/%7Bcompany_number%7D/filings?utm_source=zero.xyz - Price: $0.005/call - Payment: x402 - Status: unknown - Last checked: 2026-10-07 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/eckari-uk-companies-house-filing-history-api-ed194457 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6quCOq-NIoxhisOF35V9O Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability eckari-uk-companies-house-filing-history-api-ed194457 ``` Example prompt: Pull up the filing history for UK company number 00445790 — give me the last 10 filings, summary detail only, filtering to just the accounts category. ## When to prefer this Use this endpoint when you need programmatic, paginated access to a UK company's complete filing history from Companies House, especially when you need document URLs, category filtering (e.g. only accounts or mortgages), or annotation data. Prefer it over manual Companies House web lookups when building automated due diligence, compliance monitoring, or corporate intelligence pipelines. It is particularly well-suited for agents that need to iterate through thousands of filings using offset pagination or filter to specific regulatory categories. ## Known failure modes - Invalid company number format (not 1-8 alphanumeric chars) returns INVALID_INPUT before any payment - Company not found on Companies House register returns 404 or empty result - Category filter string with invalid characters or format is rejected - offset exceeding 10000 is rejected by schema validation - Payment failure via x402 results in 402 response with no data - Companies House upstream unavailability causes gateway error ## How this service works Eckari is the machine-native utility layer for capabilities agents do not already have. Every route is a provider-neutral capability with channel pricing for Eckari account keys and accountless x402 payment. ## Output Returns a paginated list of filing history items for the specified UK company, each containing the filing date, form type (e.g. SH03, CS01), category, human-readable description, document URL (linking to the PDF on Companies House), transaction ID, any register annotations, and whether the document was paper-filed. Also includes pagination metadata (total count, offset, has_more, next_offset) and echoes back the applied query parameters. ## Request schema (JSON Schema) ```json { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "input" ], "properties": { "input": { "type": "object", "required": [ "type", "method" ], "properties": { "type": { "type": "string", "const": "http" }, "method": { "enum": [ "GET", "HEAD", "DELETE" ], "type": "string" }, "pathParams": { "type": "object", "required": [ "company_number" ], "properties": { "company_number": { "type": "string", "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*$", "maxLength": 10, "minLength": 1, "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." } }, "additionalProperties": false }, "queryParams": { "type": "object", "properties": { "limit": { "type": "integer", "maximum": 100, "minimum": 1, "description": "Maximum filings to return per page (1-100). Default 5." }, "detail": { "enum": [ "summary", "full" ], "type": "string", "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." }, "offset": { "type": "integer", "maximum": 10000, "minimum": 0, "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." }, "category": { "type": "string", "pattern": "^[a-z-]+(,[a-z-]+)*$", "maxL … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "data": { "page": { "limit": 3, "total": 8367, "offset": 0, "has_more": true, "returned": 3, "next_offset": 3 }, "items": [ { "date": "2026-08-06", "type": "SH03", "pages": 4, "category": "capital", "annotations": [ { "date": "2026-08-06", "annotation": "Clarification HMRC confirmation received that appropriate Stamp Duty has been paid for this transaction.", "description": "annotation" } ], "description": "Purchase of own shares.", "paper_filed": true, "subcategory": null, "document_url": "https://find-and-update.company-information.service.gov.uk/company/00445790/filing-history/MzUzNjI5NTk0OWFkaXF6a2N4/document?format=pdf", "has_document": true, "transaction_id": "MzUzNjI5NTk0OWFkaXF6a2N4", "description_source": "enumeration" }, { "date": "2026-08-06", "type": "SH03", "pages": 4, "category": "capital", "annotations": [ { "date": "2026-08-06", "annotation": "Clarification HMRC confirmation received that appropriate Stamp Duty has been paid for this transaction.", "description": "annotation" } ], "description": "Purchase of own shares.", "paper_filed": true, "subcategory": null, "document_url": "https://find-and-update.company-information.service.gov.uk/company/00445790/filing-history/MzUzNjI5NTk1OWFkaXF6a2N4/document?format=pdf", "has_document": true, "transaction_id": "MzUzNjI5NTk1OWFkaXF6a2N4", "description_source": "enumeration" }, { "date": "2026-08-06", "type": "SH03", "pages": 4, "category": "capital", "annotations": [ { "date": "2026-08-06", "annotation": "Clarification HMRC confirmation received that appropriate Stamp Duty has been paid for this transaction.", "description": "annotation" } ], "description": "Purchase of own shares.", "paper_filed": true, "subcategory": null, "document_url": "https://find-and-update.company-information.service.gov.uk/company/00445790/filing-history/MzUzNjI5NTk3MWFkaXF6a2N4/document?format=pdf", "has_document": true, "transaction_id": "MzUzNjI5NTk3MWFkaXF6a2N4", "description_source": "enumeration" } ], "query": { "detail": "summary", "category": null }, "company_number": "00445790", "filing_history_status": "filing … (truncated) ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/eckari-uk-companies-house-filing-history-api-ed194457/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from api.eckari.com](https://www.zero.xyz/host/api.eckari.com/llms.txt)