{"name":"UK Companies House Company Search API","description":"Companies from the UK Companies House find-and-update service, with company name, status, type, incorporation date, registered office address, SIC codes and filing due dates.","api_id":"generated_76017000d04bddec32ffd323","slug":"uk-companies-house-company-search-api","source":{"name":"Companies House","domain":"find-and-update.company-information.service.gov.uk","url":"https://find-and-update.company-information.service.gov.uk/"},"category":"public_data","countries":["GB"],"languages":["en"],"record_types":[],"tags":[],"limitations":["Dates and SIC codes are text as the register writes them, such as 10 March 2025.","Some fields, such as the company number, may carry the incorporation date after them."],"updated":"2026-11-14","note":"Sample records are saved samples, not a live run. CleanedWeb is not affiliated with the source.","version":"1.0","versions":[{"major":1,"latest_minor":"1.0","status":"current","sunset_at":null}],"changelog":[{"version":"1.0","date":"2026-11-13T08:03:20.000Z","kind":"major","changes":[]}],"version_note":"Pin a major with \"version\": N in the run body (an integer). Leave it out and the call runs on the latest major. A sunset major runs on the latest major and the response says rerouted. An unknown major answers 404 catalog_version_not_found and lists the available majors.","endpoints":[{"endpoint_id":"generated_76017000d04bddec32ffd323_search","name":"Extract records","description":"Return records within the accepted scope.","definition_version":"e1264380e03331a007335dfa56bcf4660bab4381d1bf97b50f7c0369af34c7f3","method":"POST","path":"/v1/catalog/public/apis/generated_76017000d04bddec32ffd323/endpoints/generated_76017000d04bddec32ffd323_search/run","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_76017000d04bddec32ffd323/endpoints/generated_76017000d04bddec32ffd323_search/run","authentication":{"type":"bearer","scheme":"Authorization: Bearer <API key>","scope":"run","note":"Reading this file and the live catalog needs no credential. A run needs a CleanedWeb account and uses the credits of its workspace.","docs":"https://cleanedweb.com/docs/run-catalog-api/"},"required_headers":[{"name":"Authorization","value":"Bearer YOUR_API_KEY","description":"An API key with the run scope."},{"name":"Idempotency-Key","value":"UNIQUE_REQUEST_ID","description":"Required. Save it before you send; reuse it only to retry the same request and to read the result. 1-200 characters: letters, numbers, . _ : -"},{"name":"Content-Type","value":"application/json","description":"The body is JSON."}],"request_body":{"input":"An object that follows input_schema.","max_items":"Optional. Stop after this many records.","timeout_seconds":"Optional, 60-86400, default 10800.","wait_seconds":"Optional, 0-86400, default 90. How long the request waits before answering 202.","version":"Optional integer major. Leave it out for the latest major."},"input_schema":{"type":"object","properties":{"enrich_records":{"type":"boolean","default":true,"description":"true: read each returned record's product/detail page and merge its fields into the record. false: return list/search-level fields only, with no detail page reads. Every returned record's detail page is read within the run's time budget; records the time budget leaves unread are returned without detail fields, and summary.record_enrichment reports how many records were enriched and why any were not (run_time_budget). Detail fields are optional."},"search":{"anyOf":[{"type":"string","minLength":1,"maxLength":100,"pattern":"^[^\\x00-\\x1f\\x7f]+$","description":"Optional. Text sent to the site's own search form; its result pages are read and revalidated like the collection. Omit to read the whole collection."},{"type":"array","minItems":1,"items":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[^\\x00-\\x1f\\x7f]+$","description":"Optional. Text sent to the site's own search form; its result pages are read and revalidated like the collection. Omit to read the whole collection."}}],"description":"Optional. Text sent to the site's own search form; its result pages are read and revalidated like the collection. Omit to use the default: bakery. Supply an array to union distinct results from each source search, in query order.","default":"bakery","x-source-key":"q"}},"required":[],"additionalProperties":false},"output_schema":{"type":"object","additionalProperties":false,"required":["title","url"],"properties":{"address":{"type":"string"},"company_number":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"company_name":{"type":"string"},"company_status":{"type":"string","description":"Company status"},"company_type":{"type":"string","description":"Company type"},"incorporated_on":{"type":"string","description":"Incorporated on"},"last_confirmation_statement_date":{"type":"string"},"nature_of_business_sic":{"type":"string"},"registered_office_address":{"type":"string","description":"Registered office address"},"accounts":{"type":"string","description":"Accounts"},"confirmation_statement":{"type":"string","description":"Confirmation statement"},"dissolved_on":{"type":"string","description":"Dissolved on"},"accounts_made_up_to":{"type":"string"},"accounts_due_date":{"type":"string"},"next_confirmation_statement_date":{"type":"string"},"confirmation_statement_due_date":{"type":"string"},"sic_codes":{"type":"string"}}},"examples":[{"kind":"saved_validation_records","saved_at":"2026-11-13T08:03:20.130Z","live_verified":false,"request":{"input":{}},"records_shown":2,"records_saved":2,"records":[{"accounts":"First accounts made up to                            31 March 2026 due by 10 December 2026","accounts_due_date":"10 December 2026","accounts_made_up_to":"31 March 2026","address":"C/O Ashley Richmond Accountants Ltd, Argyle House Joel Street, Northwood Hills, United Kingdom, HA6 1NW","company_name":"BAKERY ALTERNATIVE LTD","company_number":"16303163 - Incorporated on 10 March 2025","company_status":"Active","company_type":"Private limited Company","confirmation_statement":"Next statement date                        9 March 2027 due by 23 March 2027","confirmation_statement_due_date":"23 March 2027","incorporated_on":"10 March 2025","last_confirmation_statement_date":"9 March 2026","nature_of_business_sic":"10710 - Manufacture of bread; manufacture of fresh pastry goods and cakes","next_confirmation_statement_date":"9 March 2027","registered_office_address":"C/O Ashley Richmond Accountants Ltd, Argyle House Joel Street, Northwood Hills, United Kingdom, HA6 1NW","sic_codes":"10710 - Manufacture of bread; manufacture of fresh pastry goods and cakes","title":"BAKERY ALTERNATIVE LTD","url":"https://find-and-update.company-information.service.gov.uk/company/16303163"},{"accounts":"Next accounts made up to                            31 July 2026 due by 30 April 2027","accounts_due_date":"30 April 2027","address":"12783097 - Incorporated on 31 July 2020","company_name":"BAKERY BRITISH PATAGONIA LIMITED","company_status":"Active","company_type":"Private limited Company","confirmation_statement":"Next statement date                        31 March 2027 due by 14 April 2027","confirmation_statement_due_date":"14 April 2027","incorporated_on":"31 July 2020","last_confirmation_statement_date":"31 March 2026","nature_of_business_sic":"10710 - Manufacture of bread; manufacture of fresh pastry goods and cakes","next_confirmation_statement_date":"31 March 2027","registered_office_address":"5 Canon Court, Institute Street, Bolton, England, BL1 1PZ","sic_codes":"10710 - Manufacture of bread; manufacture of fresh pastry goods and cakes","title":"BAKERY BRITISH PATAGONIA LIMITED","url":"https://find-and-update.company-information.service.gov.uk/company/12783097"}]}],"request_example":{"body":{"input":{},"version":1,"max_items":25},"curl":"curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_76017000d04bddec32ffd323/endpoints/generated_76017000d04bddec32ffd323_search/run \\\n  -H \"Authorization: Bearer YOUR_API_KEY\" \\\n  -H \"Idempotency-Key: UNIQUE_REQUEST_ID\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"input\": {},\n  \"version\": 1,\n  \"max_items\": 25\n}'"},"result":{"method":"GET","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_76017000d04bddec32ffd323/endpoints/generated_76017000d04bddec32ffd323_search/result","note":"A run that does not end within wait_seconds answers 202. Read the result with the same API key and the same Idempotency-Key."},"links":{"page":"https://cleanedweb.com/catalog/uk-companies-house-company-search-api/","markdown":"https://cleanedweb.com/catalog/uk-companies-house-company-search-api/index.md","live_contract":"https://app.cleanedweb.com/api/catalog/apis/generated_76017000d04bddec32ffd323/endpoints/generated_76017000d04bddec32ffd323_search/contract","run_docs":"https://cleanedweb.com/docs/run-catalog-api/"}}],"links":{"page":"https://cleanedweb.com/catalog/uk-companies-house-company-search-api/","markdown":"https://cleanedweb.com/catalog/uk-companies-house-company-search-api/index.md","contract":"https://cleanedweb.com/catalog/uk-companies-house-company-search-api/contract.json","catalog":"https://cleanedweb.com/catalog/","index":"https://cleanedweb.com/catalog/index.json","openapi":"https://cleanedweb.com/catalog/openapi.json"}}
