{"uid":"cap_l3XwbCUaqbGGwg10-tg8R","slug":"uk-company-filing-history-588ef248","name":"UK Company Filing History","description":"Recent filings and key dates for a UK company from the Companies House public register: accounts and confirmation statement dates and the latest filings by date and form type, as JSON. Officer and PSC filings are excluded.","url":"https://pennydatahq.com/api/filings/:number?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"],"type":"string"},"pathParams":{"type":"object","required":["number"],"properties":{"number":{"type":"string","description":"Companies House company number: up to 8 digits, or a 2-letter prefix such as SC followed by digits."}}},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["company_number","company_name","key_dates","filings"],"properties":{"status":{"type":["string","null"]},"filings":{"type":"array","items":{"type":"object","properties":{"date":{"type":["string","null"],"description":"YYYY-MM-DD"},"form":{"type":["string","null"],"description":"Companies House form type, for example AA or CS01"},"category":{"type":["string","null"]},"made_up_date":{"type":["string","null"],"description":"YYYY-MM-DD"},"description_code":{"type":["string","null"],"description":"Companies House filing description key"}}},"description":"Up to 25, newest first; officer and PSC filings excluded"},"key_dates":{"type":"object","properties":{"accounts":{"type":"object","properties":{"overdue":{"type":["boolean","null"]},"next_due":{"type":["string","null"],"description":"YYYY-MM-DD"},"last_made_up_to":{"type":["string","null"],"description":"YYYY-MM-DD"},"next_made_up_to":{"type":["string","null"],"description":"YYYY-MM-DD"}}},"dissolution_date":{"type":["string","null"],"description":"YYYY-MM-DD"},"incorporation_date":{"type":["string","null"],"description":"YYYY-MM-DD"},"confirmation_statement":{"type":"object","properties":{"overdue":{"type":["boolean","null"]},"next_due":{"type":["string","null"],"description":"YYYY-MM-DD"},"last_made_up_to":{"type":["string","null"],"description":"YYYY-MM-DD"},"next_made_up_to":{"type":["string","null"],"description":"YYYY-MM-DD"}}}}},"company_name":{"type":"string"},"total_filings":{"type":["integer","null"],"description":"All filings on the register, including excluded ones"},"company_number":{"type":"string"}}}}}}},"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_FL4e_OknwkCqaOVCqaE9v","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 recent filing history and key compliance dates for a UK company from Companies House, excluding officer and PSC filings.","exampleAgentPrompt":"Can you pull the recent filing history for UK company number 09876543 from Companies House — I want to see the latest filings and check when their accounts and confirmation statement are next due.","exampleUseCases":[{"title":"Check if accounts are overdue","prompt":"Look up Companies House filings for company number 07415985 and tell me whether their accounts are overdue and when the next ones are due."},{"title":"Due diligence on a supplier","prompt":"I need to do a quick compliance check on a supplier — their Companies House number is SC123456. Can you get their recent filing history and flag if anything looks overdue?"},{"title":"Monitor a competitor's filings","prompt":"What has company number 00445790 filed recently at Companies House? Show me the latest filings by date and let me know when their confirmation statement is next due."}],"resultDescription":"A JSON object containing the company number, company name, key compliance dates (accounts and confirmation statement next-due and last-made-up-to dates, overdue flags, incorporation date, dissolution date), and up to 25 most recent filings (excluding officer and PSC filings) each with date, form type, category, made-up date, and description code.","failureModes":["Invalid or non-existent company number returns an error or empty result","Company number format must be up to 8 digits or a valid 2-letter prefix (e.g. SC) followed by digits — malformed inputs will fail","Dissolved companies may return limited or no filing data","Companies House API downtime may cause upstream failures","Truncated response — only up to 25 filings returned, older history not available"],"whenToPreferThis":"Use this endpoint when you need structured, machine-readable UK Companies House filing data for a known company number, particularly for compliance checks, due diligence workflows, or monitoring accounts and confirmation statement deadlines. It is preferable over scraping Companies House directly due to its JSON output and pay-per-call pricing. Choose it when you need recent filing history without officer or PSC appointment data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-03T15:15:15.405Z","isFirstParty":false,"canonicalSlug":"uk-company-filing-history-588ef248"}