{"uid":"cap_1d0slfV80VQyHM9tW8kiw","slug":"eckari-uk-company-filing-history-57ef57dc","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/:company_number/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__cjOMcbIwsfmLszgFjqW7","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, and mortgages, ordered most recent first with document URLs.","exampleAgentPrompt":"Can you pull the filing history for UK company number 00445790 from Companies House — show me the last 10 filings and filter to accounts and confirmation statements only?","exampleUseCases":[{"title":"Due diligence filing audit","prompt":"I'm doing due diligence on a UK company with number 09876543 — can you get me the last 20 filings from Companies House so I can see their accounts, confirmation statements, and any mortgage charges?"},{"title":"Officer change monitoring","prompt":"Can you check the Companies House filing history for company number 01234567 and show me only the officer appointment and termination filings so I can track who has joined or left the board?"},{"title":"Compliance confirmation check","prompt":"Has company number 07654321 filed a confirmation statement in the last 12 months? Pull their recent filings from Companies House filtered to confirmation-statement category and let me know."}],"resultDescription":"A paginated list of filings for the specified UK company, each containing the filing date, form type code (e.g. AA, CS01, AP01, TM01), a human-readable description, registrar annotations, and a document_url for the filed image. In full detail mode, also includes raw description_key and description_values. The response includes page metadata with total count, current offset, and a next_offset for pagination.","failureModes":["Invalid or malformed company number (not matching 1-8 alphanumeric characters) returns INVALID_INPUT before any payment","Company number not found in Companies House register returns a not-found error","Invalid category filter string (wrong format or unknown category) returns a validation error","Offset exceeding 10000 or limit outside 1-100 range returns a validation error","Companies House upstream API unavailability causes a service error","Payment of 0.005 USDC via x402 protocol required; insufficient funds or missing payment header causes a 402 response"],"whenToPreferThis":"Use this endpoint when you need structured, paginated filing history for a specific UK company from the official Companies House register, especially when you want to filter by filing category (e.g. accounts, officers, mortgages), retrieve document URLs for filed images, or monitor recent compliance activity. Prefer this over scraping Companies House directly or using generic web search when you need machine-readable, reliable, structured output per filing with form codes and registrar annotations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:41:14.046Z","isFirstParty":false,"canonicalSlug":"eckari-uk-company-filing-history-e751259c"}