{"uid":"cap_7MsnyQyfw09S8CCv18Qks","slug":"eckari-uk-company-accounts-filing-status-c2d8e887","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/:company_number/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_8L6QfgS1waqVWRDNktyiY","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 Companies House company, including accounting reference date, last filed accounts type and period, next due date, and an overdue flag.","exampleAgentPrompt":"Can you check the accounts filing status for UK company number 09876543 — specifically when the next accounts are due and whether they're overdue?","exampleUseCases":[{"title":"Due diligence on a UK supplier","prompt":"I'm about to sign a contract with a UK company whose registration number is 04567890 — can you check whether their Companies House accounts are up to date and when the next filing is due?"},{"title":"Monitoring a portfolio company's compliance","prompt":"Check the accounts filing status for our portfolio company registered as 00445790 in the UK — I need to know if they're overdue and what period their last accounts covered."},{"title":"Credit risk check on a UK business","prompt":"We're considering extending credit to a UK firm with company number 07123456. Can you look up their accounts filing position on Companies House so I can see if they're behind on filings?"}],"resultDescription":"Returns the company's accounting reference date, the type and period of the most recently filed accounts, the next accounts due date, and a derived boolean overdue flag indicating whether the company has missed its filing deadline. No financial statement figures (turnover, profit, balance sheet) are included.","failureModes":["Invalid or malformed company number (not matching ^[A-Za-z0-9]{1,8}$) returns INVALID_INPUT before any payment is charged","Company number not found in Companies House register returns a not-found error","Whitespace-only or overly long company number is rejected as INVALID_INPUT","Companies House upstream unavailability may cause transient errors","Dissolved or struck-off companies may return limited or historical data"],"whenToPreferThis":"Use this endpoint when you need the accounts filing position of a UK-registered company — specifically the due dates, overdue status, and last filed accounts metadata — without needing the actual financial statements. Prefer this over general company profile lookups when the question is specifically about filing compliance or deadlines. This is more targeted than a full company profile endpoint and cheaper per call when only accounts status is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:44:36.652Z","isFirstParty":false}