{"uid":"cap_5BoA77y4QfYo6PBtd29v8","slug":"eckari-uk-company-accounts-filing-status-6f076231","name":"Eckari UK Company Accounts Filing Status","description":"Return the accounts filing status of a UK company from the Companies House register — the accounting reference date, the last accounts filed (type and period), the next accounts due date and a derived overdue flag. This is the filing position, not the financial statements: no turnover, profit or balance-sheet figures are published here. Use when: When are this UK company's accounts due?","url":"https://api.eckari.com/v1/companies/uk/:companyNumber/accounts","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, also called the company registration number (CRN). 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":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-PEJUUpUlmFVGnUbXngCM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the accounts filing status of a UK company from Companies House, including accounting reference date, last accounts filed, next due date, and overdue flag.","exampleAgentPrompt":"Can you check whether the accounts for UK company number 09876543 are up to date and when the next filing is due?","exampleUseCases":[{"title":"Due diligence on a UK supplier","prompt":"I'm about to sign a contract with a UK supplier registered as company number 04567890 — can you check if their Companies House accounts are current and not overdue?"},{"title":"Portfolio compliance monitoring","prompt":"We hold shares in a UK company with registration number 07123456 — can you look up their accounts filing status and tell me when the next deadline is and whether they're overdue?"},{"title":"Credit risk check on a prospect","prompt":"Before we extend credit to this UK business, can you pull their Companies House accounts filing status for company number 00445790 — I need to know the last accounts type, the period they covered, and if anything is overdue?"}],"resultDescription":"Returns the Companies House accounts filing position for the specified UK company: the accounting reference date, details of the most recently filed accounts (type and period covered), the next accounts due date, and a derived boolean flag indicating whether accounts are currently overdue. Does not include financial statement data such as turnover, profit, or balance-sheet figures.","failureModes":["Invalid or malformed company number (e.g. contains spaces, exceeds 8 alphanumeric characters) returns INVALID_INPUT before any payment is charged","Company number not found in Companies House register returns a not-found error","Company has never filed accounts — fields for last accounts may be null or absent","Upstream Companies House API unavailability may cause transient errors","Whitespace-only input is rejected as INVALID_INPUT"],"whenToPreferThis":"Use this endpoint when you need the accounts filing position of a UK-registered company — specifically the due dates, filing history type, and overdue status — rather than financial content. Prefer this over generic company data endpoints when compliance monitoring, credit checks, or due diligence workflows require knowing whether a company is current with its annual accounts obligation at Companies House.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:52:25.220Z","isFirstParty":false}