{"uid":"cap_6quCOq-NIoxhisOF35V9O","slug":"eckari-uk-companies-house-filing-history-api-ed194457","name":"Eckari UK Companies House Filing History API","description":"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.","url":"https://api.eckari.com/v1/companies/uk/%7Bcompany_number%7D/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":{"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-history-available","is_filing_history_available":true},"meta":{"source":"companies_house","version":"3.0.0","freshness":"live","capability":"company.uk.filings"}}},"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_0pdNxZfHMipMOwIzEOHLA","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":"Retrieves paginated filing history for a UK company from Companies House, including document URLs, form types, categories, and annotations.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Due diligence on UK acquisition target","prompt":"I'm doing due diligence on a potential acquisition — can you pull the full filing history for UK company 03849656, starting from the beginning, and flag any liquidation or mortgage filings?"},{"title":"Tracking share capital changes","prompt":"Get me the capital-category filings for UK company 00445790 — I want to see all the share purchase and allotment documents they've filed, up to 50 at a time."},{"title":"Verifying incorporation and officer history","prompt":"Look up the incorporation and officers filings for UK company number 07495895 so I can verify when it was set up and who the original directors were."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-07T06:48:32.154Z","isFirstParty":false,"canonicalSlug":"eckari-uk-companies-house-filing-history-api-ed194457"}