{"uid":"cap_EQ5LCcNXjRGKal7ObIWtm","slug":"eckari-uk-company-filing-history-e751259c","name":"Eckari UK Company Filing History","description":"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?","url":"https://api.eckari.com/v1/companies/uk/:companyNumber/filings?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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-]+)*$","maxLength":200,"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."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jf8VBe7C3wOzBgKDQRnh-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the filing history of a UK company from Companies House, including accounts, confirmation statements, officer changes, address changes, and mortgages, paginated and filterable by category","exampleAgentPrompt":"Can you pull up the filing history for UK company number 00445790 from Companies House — show me the last 10 filings, filtered to accounts and confirmation statements, with full detail including document URLs?","exampleUseCases":[{"title":"Due diligence on a UK supplier","prompt":"I need to check what a potential UK supplier has filed recently — their company number is 04123456. Can you get me their last 20 Companies House filings, especially any accounts and officer changes, so I can see if anything looks off?"},{"title":"Monitoring a competitor's corporate activity","prompt":"Can you check the filing history for UK company 07688736 and filter it to just officer appointments and resignations? I want to see if there have been any director changes in the past year."},{"title":"Verifying a company's mortgage and charge filings","prompt":"Pull up the mortgage and charge filings for UK company number 00002065 from Companies House — I want to see if they have any outstanding charges registered against them."}],"resultDescription":"A paginated list of filings for the specified UK company, each including the filing date, form type code (e.g. AA, CS01, AP01), a human-readable description, registrar annotations, and a document_url linking to the filed image. In full detail mode, also includes the raw description_key and description_values. Pagination metadata indicates total filings, whether more pages exist, and the next offset to use.","failureModes":["Invalid company number format (must be 1-8 alphanumeric characters) returns INVALID_INPUT before any payment","Company number not found in Companies House register returns a 404-equivalent error","Category filter value not matching allowed register categories may return empty results or validation error","Offset exceeding total filings returns an empty result set","Rate limiting or upstream Companies House API unavailability may cause transient errors"],"whenToPreferThis":"Use this endpoint when you need the chronological filing history of a specific UK company — including accounts, confirmation statements, officer changes, mortgages, and resolutions — sourced directly from the Companies House register. Prefer this over a general company profile lookup when you need to audit compliance history, check recent corporate events, or retrieve document URLs for filed forms. It is especially useful for due diligence workflows, compliance monitoring, and corporate intelligence tasks focused on UK-registered entities.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T00:31:09.853Z","isFirstParty":false,"canonicalSlug":"eckari-uk-company-filing-history-e751259c"}