# Companies House API: List company filing history > Lists a UK company's Companies House filings, newest first, with date, form code, type, description, page count and PDF link. Finds the company by name, company number or Companies House link; a category picks accounts, confirmation statements, officers, address, capital, charges or incorporation filings. Unofficial. Not affiliated with or endorsed by Companies House. - Page: https://fous.com/methods/find-and-update.company-information.service.gov.uk/list-filing-history - Method: `find-and-update.company-information.service.gov.uk/list_filing_history`, version 1 - Website: find-and-update.company-information.service.gov.uk - Returns: company name, company number, filings (date, type, description, pages, PDF link, page link, form code, transaction ID) - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `company` | string | yes | `"00445790"` | UK company name, company number or Companies House company link, for example Tesco PLC. | | `max_results` | integer | no | `100` | Maximum filings to return, for example 20 (up to 100). Default 20. | | `filing_category` | string | no | `"all"` | Choose which filings to list, for example accounts. One of "all", "accounts", "confirmation_statements", "officers", "address", "capital", "charges", "incorporation". Default "all". | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "company": "00445790", "max_results": 100, "filing_category": "all" } ``` Its output: ```json { "filings": [ { "form_code": "SH03", "page_link": "https://find-and-update.company-information.service.gov.uk/company/00445790/filing-history/MzU0MzY3ODg5MGFkaXF6a2N4/document", "description": "Purchase of own shares. Clarification hmrc confirmation received that appropriate duty has been paid on this repurchase", "filing_date": "2026-09-16", "filing_type": "Purchase of own shares", "transaction_id": "MzU0MzY3ODg5MGFkaXF6a2N4", "number_of_pages": 4, "document_pdf_link": "https://find-and-update.company-information.service.gov.uk/company/00445790/filing-history/MzU0MzY3ODg5MGFkaXF6a2N4/document?format=pdf&download=0" }, { "form_code": "SH06", "page_link": "https://find-and-update.company-information.service.gov.uk/company/00445790/filing-history/MzUzOTMzNzQ1OWFkaXF6a2N4/document", "description": "Cancellation of shares. Statement of capital on 7 July 2026 GBP 397,007,409.26", "filing_date": "2026-08-26", "filing_type": "Cancellation of shares", "transaction_id": "MzUzOTMzNzQ1OWFkaXF6a2N4", "number_of_pages": 4, "document_pdf_link": "https://find-and-update.company-information.service.gov.uk/company/00445790/filing-history/MzUzOTMzNzQ1OWFkaXF6a2N4/document?format=pdf&download=0" }, { "form_code": "SH06", "page_link": "https://find-and-update.company-information.service.gov.uk/company/00445790/filing-history/MzUzOTMzNzMyN2FkaXF6a2N4/document", "description": "Cancellation of shares. Statement of capital on 30 June 2026 GBP 398,210,742.59", "filing_date": "2026-08-26", "filing_type": "Cancellation of shares", "transaction_id": "MzUzOTMzNzMyN2FkaXF6a2N4", "number_of_pages": 4, "document_pdf_link": "https://find-and-update.company-information.service.gov.uk/company/00445790/filing-history/MzUzOTMzNzMyN2FkaXF6a2N4/document?format=pdf&download=0" } ], "company_name": "TESCO PLC", "company_number": "00445790" } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"find-and-update.company-information.service.gov.uk/list_filing_history","input":{"company":"00445790","max_results":100,"filing_category":"all"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Show me the last 10 accounts filings for Tesco PLC with links to the PDFs - What has company number 00445790 filed recently? I need dates, form codes and descriptions for the latest 30 filings. - Pull the director appointment and resignation filings for Deliveroo Holdings on Companies House - I need every charge-related filing for Greggs plc, as many as you can get up to 100, so I can check their mortgages and charges history - List the confirmation statements Monzo Bank Limited has submitted to Companies House, newest first ## Input schema ```json { "type": "object", "required": [ "company" ], "properties": { "company": { "type": "string", "description": "UK company name, company number or Companies House company link, for example Tesco PLC." }, "max_results": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1, "description": "Maximum filings to return, for example 20 (up to 100)." }, "filing_category": { "enum": [ "all", "accounts", "confirmation_statements", "officers", "address", "capital", "charges", "incorporation" ], "type": "string", "default": "all", "description": "Choose which filings to list, for example accounts." } } } ``` ## Output schema ```json { "type": "object", "required": [ "company_name", "company_number", "filings" ], "properties": { "filings": { "type": "array", "items": { "type": "object", "required": [ "filing_date", "filing_type", "description", "number_of_pages", "document_pdf_link", "page_link", "form_code", "transaction_id" ], "properties": { "form_code": { "type": [ "string", "null" ], "x-fous-developer": true }, "page_link": { "type": "string" }, "description": { "type": "string" }, "filing_date": { "type": "string", "format": "date" }, "filing_type": { "type": "string" }, "transaction_id": { "type": [ "string", "null" ], "x-fous-developer": true }, "number_of_pages": { "type": [ "integer", "null" ] }, "document_pdf_link": { "type": [ "string", "null" ] } }, "additionalProperties": false } }, "company_name": { "type": "string" }, "company_number": { "type": "string" } }, "additionalProperties": false } ``` ## See more - [Companies House API: Search companies](https://fous.com/methods/find-and-update.company-information.service.gov.uk/search-companies.md): Searches the UK Companies House register by company name and returns each company's status, type, incorporation date and registered office address, in result order. - [Companies House API: Get UK company profile](https://fous.com/methods/company-information.service.gov.uk/get-company-profile.md): Looks up a UK company on Companies House by name, company number or Companies House link and returns its public registration details; a name prefers an active exact match. - [Companies House API: List company directors](https://fous.com/methods/find-and-update.company-information.service.gov.uk/list-directors.md): Lists a UK company's current and resigned directors, secretaries and other officers, found by company name, number or Companies House link. - [Companies House API: List company owners](https://fous.com/methods/find-and-update.company-information.service.gov.uk/list-owners.md): Lists a UK company's people with significant control and any register statement, from the public Companies House register. Ceased owners and withdrawn statements are included only when asked for. - [SEC EDGAR API: List company SEC filings](https://fous.com/methods/sec.gov/get-company-filings.md): Finds a public company by name or ticker in SEC EDGAR and lists its filings, newest first, optionally narrowed by filing type and filing date. - [SEC EDGAR API: List insider trades](https://fous.com/methods/sec.gov/list-insider-trades.md): Lists stock transactions reported on Form 4 filings by a company's officers, directors and major owners, newest first. Trades without a reported price have no calculated value. - [Trustpilot API: Search companies](https://fous.com/methods/trustpilot.com/search-companies.md): Finds companies on Trustpilot by name or what they do, with TrustScore, review count, categories, location, logo and links. A preferred country moves companies listed in that country to the front. - [SEC EDGAR API: Get company financials](https://fous.com/methods/sec.gov/get-company-financials.md): Looks up a public company by name or ticker on SEC EDGAR and returns its reported annual or quarterly financial figures from XBRL company facts. Quarterly flows are derived from year-to-date totals when no quarterly figure is filed. Unavailable figures are null. - [All Companies House methods](https://fous.com/methods/company-information.service.gov.uk.md)