# Companies House UK Financials & Beneficial Owners Scraper (`jungle_synthesizer/companies-house-uk-financials-scraper`) Actor Extract UK company records from Companies House with parsed iXBRL accounts (turnover, profit, assets, director pay), officers, beneficial owners (PSCs), and charges. Query by company number, name, SIC code, or PSC name. Built for due-diligence, KYC/KYB, and M\&A targeting. - **URL**: https://apify.com/jungle\_synthesizer/companies-house-uk-financials-scraper.md - **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community) - **Categories:** Business, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Companies House UK Financials & Beneficial Owners Scraper Extract UK company records from [Companies House](https://find-and-update.company-information.service.gov.uk/) with **parsed filed accounts** (iXBRL) — turnover, profit, assets, director pay — plus officers, beneficial owners (Persons with Significant Control), and registered charges. Other Companies House actors stop at basic profile fields; this one parses the actual filed accounts documents into structured financials. ### What You Get Each record includes: **Company profile** - Company number, name, status (active/dissolved/liquidation), type (ltd/plc/llp/…) - Incorporation date, registered office address, SIC codes - Insolvency history flag, charges flag + counts (total / outstanding) - Filing history entry count **Officers & beneficial ownership** (each independently toggleable) - Officers — JSON array of `{name, role, appointed, resigned}` - Active directors count - PSCs (Persons with Significant Control / beneficial owners) — JSON array of `{name, kind, natures_of_control, notified_on}` **Parsed financials** (from the company's filed iXBRL accounts, when `includeFinancials` is on) - Turnover, gross profit, operating profit, profit before/after tax - Total assets, total-assets-less-current-liabilities, current assets, total liabilities, net assets - Cash at bank, average employees, director remuneration, highest-paid director, audit firm name - Accounts period end date and `accounts_year` (1 = most recently filed year) **Every financial field is null when the filer didn't tag that concept — never fabricated.** Many small companies file abridged/micro-entity accounts that only disclose the balance sheet (assets, employees), not a profit & loss statement — turnover and profit legitimately come back `null` for those. `total_assets_gbp` is reserved for a genuine gross-assets tag; the very common small-company subtotal ("total assets less current liabilities" — fixed assets + net current assets) is a distinct, separately-reported field, `total_assets_less_current_liabilities_gbp`, so the two are never conflated. ### Billing Unit One record = one company profile (when `includeFinancials` is off, or a company has no accounts filings) **or** one company-year of parsed financials (when `includeFinancials` is on — one row per requested `financialYears`, each with its own `accounts_year`). Base company/officer/PSC/charge fields repeat across each year's row for the same company. ### Query Modes | Mode | Uses input field | What it does | |---|---|---| | `by_company_number` | `companyNumbers` | Direct lookup — you already know the company number(s) | | `by_name` | `names` | Keyword search against company names (Companies House `/search/companies`) | | `by_sic_code` | `sicCodes` | Companies matching a [UK SIC 2007 code](https://resources.companieshouse.gov.uk/sic/) | | `by_psc_name` | `pscNames` | Search for companies by a beneficial owner's name | | `advanced_search` | `names` | Company-name-includes substring search | **Known limitation — `by_psc_name`:** Companies House's documented `/search/persons-with-significant-control` endpoint returned zero results for every query tried against the standard free-tier API key during construction — including an exact name pulled straight from a real company's own live PSC record. The mode is wired per the documented API, but in practice you'll get more reliable beneficial-ownership data via `by_company_number` + `includePscs: true` against a company you already know. ### Inputs | Field | Type | Default | Description | |---|---|---|---| | `mode` | select | `by_company_number` | Query mode — see table above | | `companyNumbers` | array | — | Companies House company numbers (mode = by_company_number) | | `names` | array | — | Company names / keywords (mode = by_name or advanced_search) | | `sicCodes` | array | — | UK SIC 2007 codes (mode = by_sic_code) | | `pscNames` | array | — | Beneficial owner names (mode = by_psc_name) | | `includeFinancials` | boolean | `true` | Download + parse filed iXBRL accounts | | `financialYears` | integer | `3` | How many years of accounts filings to parse per company (max 10) | | `includePscs` | boolean | `true` | Include Persons with Significant Control | | `includeOfficers` | boolean | `true` | Include officers (directors/secretaries) | | `includeCharges` | boolean | `false` | Include registered charges (liens) | | `maxItems` | integer | `100` | Maximum number of records (company-years) to process | ### Example Output ```json { "company_number": "10122954", "company_name": "DRAGONS HEAD SHOP LTD", "company_status": "active", "company_type": "ltd", "incorporation_date": "2016-04-14", "registered_office_address": "14, Broadview Road, London, SW16 5AU", "sic_codes": "47910|62012", "accounts_last_made_up_to": "2022-04-30", "accounts_next_due": "2027-01-31", "accounts_overdue": false, "has_been_liquidated": false, "has_charges": false, "total_charges_count": 0, "outstanding_charges_count": 0, "officers_count": 2, "active_directors_count": 2, "officers": "[{\"name\":\"Mr Lee Brook\",\"role\":\"director\",\"appointed\":\"2016-04-14\",\"resigned\":null}]", "psc_count": 2, "psc_controllers": "[{\"name\":\"Mr Lee Brook\",\"kind\":\"individual-person-with-significant-control\",\"natures_of_control\":\"ownership-of-shares-25-to-50-percent\",\"notified_on\":\"2016-04-14\"}]", "filing_history_count": 12, "accounts_period_end": "2022-04-30", "turnover_gbp": null, "gross_profit_gbp": null, "operating_profit_gbp": null, "profit_before_tax_gbp": null, "profit_after_tax_gbp": null, "total_assets_gbp": null, "total_assets_less_current_liabilities_gbp": 9616, "current_assets_gbp": 9032, "total_liabilities_gbp": null, "net_assets_gbp": 7656, "cash_at_bank_gbp": null, "employees_average": 2, "director_remuneration_gbp": null, "highest_paid_director_gbp": null, "audit_firm_name": null, "accounts_year": 1 } ```` This example is a real micro-entity filing — note turnover/profit are correctly `null` (this company's abridged accounts don't tag a profit & loss statement), while the balance-sheet fields that were actually tagged (assets, net assets, employees) come back as real numbers. ### Notes - This actor calls the official Companies House [REST API](https://developer-specs.company-information.service.gov.uk/) and [Document API](https://developer-specs.company-information.service.gov.uk/document-api/reference) directly. It does not scrape HTML. - iXBRL parsing matches concepts by their FRC taxonomy **local name**, independent of the namespace prefix a filer's accounting software assigns (different real filings use `uk-bus:`, `uk-core:`, `core:`, or custom prefixes for the identical concept). - Where a concept is tagged more than once (current year, prior-year comparative, or a dimensional note breakdown), the parser prefers the primary (non-dimensional) statement figure for the most recent period. - This actor uses a single orblabs-managed API key shared across all runs (and with the sibling uk-companies-house-scraper actor) — you never need to supply your own. # Actor input Schema ## `sp_intended_usage` (type: `string`): Please describe how you plan to use the data extracted by this crawler. ## `sp_improvement_suggestions` (type: `string`): Provide any feedback or suggestions for improvements. ## `sp_contact` (type: `string`): Provide your email address so we can get in touch with you. ## `mode` (type: `string`): How to select companies. by\_company\_number/by\_name/by\_sic\_code/by\_psc\_name use the matching list field below; advanced\_search uses the 'names' field as a free-text company-name-includes query. ## `companyNumbers` (type: `array`): Companies House company numbers (e.g. 00445790). Used when mode = by\_company\_number. ## `names` (type: `array`): Company names or keywords to search. Used when mode = by\_name or advanced\_search. ## `sicCodes` (type: `array`): UK SIC 2007 codes (e.g. 62012). Used when mode = by\_sic\_code. Full list: https://resources.companieshouse.gov.uk/sic/ ## `pscNames` (type: `array`): Names of Persons with Significant Control to search for. Used when mode = by\_psc\_name. ## `includeFinancials` (type: `boolean`): Download and parse the most recent filed accounts documents into structured financials (turnover, profit, assets, director pay). Fields come back null where the filer did not tag that concept — never fabricated. ## `financialYears` (type: `integer`): Number of historical accounts filings to parse per company (max 10). Each parsed year is one billed record. ## `includePscs` (type: `boolean`): No description ## `includeOfficers` (type: `boolean`): No description ## `includeCharges` (type: `boolean`): No description ## `maxItems` (type: `integer`): Maximum number of records (company-years) to process. ## Actor input object example ```json { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "mode": "by_company_number", "includeFinancials": true, "financialYears": 3, "includePscs": true, "includeOfficers": true, "maxItems": 100 } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "mode": "by_company_number", "includeFinancials": true, "financialYears": 3, "includePscs": true, "includeOfficers": true, "includeCharges": false, "maxItems": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("jungle_synthesizer/companies-house-uk-financials-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "mode": "by_company_number", "includeFinancials": True, "financialYears": 3, "includePscs": True, "includeOfficers": True, "includeCharges": False, "maxItems": 100, } # Run the Actor and wait for it to finish run = client.actor("jungle_synthesizer/companies-house-uk-financials-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "mode": "by_company_number", "includeFinancials": true, "financialYears": 3, "includePscs": true, "includeOfficers": true, "includeCharges": false, "maxItems": 100 }' | apify call jungle_synthesizer/companies-house-uk-financials-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jungle_synthesizer/companies-house-uk-financials-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Companies House UK Financials & Beneficial Owners Scraper", "description": "Extract UK company records from Companies House with parsed iXBRL accounts (turnover, profit, assets, director pay), officers, beneficial owners (PSCs), and charges. Query by company number, name, SIC code, or PSC name. Built for due-diligence, KYC/KYB, and M&A targeting.", "version": "1.0", "x-build-id": "lUJraRKISSRaG6Scq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~companies-house-uk-financials-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-companies-house-uk-financials-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/jungle_synthesizer~companies-house-uk-financials-scraper/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-companies-house-uk-financials-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/jungle_synthesizer~companies-house-uk-financials-scraper/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-companies-house-uk-financials-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "sp_intended_usage", "sp_improvement_suggestions" ], "properties": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "Please describe how you plan to use the data extracted by this crawler." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact Email", "minLength": 1, "type": "string", "description": "Provide your email address so we can get in touch with you." }, "mode": { "title": "Query Mode", "enum": [ "by_company_number", "by_name", "by_sic_code", "by_psc_name", "advanced_search" ], "type": "string", "description": "How to select companies. by_company_number/by_name/by_sic_code/by_psc_name use the matching list field below; advanced_search uses the 'names' field as a free-text company-name-includes query." }, "companyNumbers": { "title": "Company Numbers", "type": "array", "description": "Companies House company numbers (e.g. 00445790). Used when mode = by_company_number.", "items": { "type": "string" } }, "names": { "title": "Names", "type": "array", "description": "Company names or keywords to search. Used when mode = by_name or advanced_search.", "items": { "type": "string" } }, "sicCodes": { "title": "SIC Codes", "type": "array", "description": "UK SIC 2007 codes (e.g. 62012). Used when mode = by_sic_code. Full list: https://resources.companieshouse.gov.uk/sic/", "items": { "type": "string" } }, "pscNames": { "title": "PSC (Beneficial Owner) Names", "type": "array", "description": "Names of Persons with Significant Control to search for. Used when mode = by_psc_name.", "items": { "type": "string" } }, "includeFinancials": { "title": "Parse Filed Accounts (iXBRL)", "type": "boolean", "description": "Download and parse the most recent filed accounts documents into structured financials (turnover, profit, assets, director pay). Fields come back null where the filer did not tag that concept — never fabricated." }, "financialYears": { "title": "Years of Financials to Parse", "minimum": 1, "maximum": 10, "type": "integer", "description": "Number of historical accounts filings to parse per company (max 10). Each parsed year is one billed record." }, "includePscs": { "title": "Include Persons with Significant Control", "type": "boolean", "description": "" }, "includeOfficers": { "title": "Include Officers (Directors/Secretaries)", "type": "boolean", "description": "" }, "includeCharges": { "title": "Include Charges (Liens)", "type": "boolean", "description": "" }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of records (company-years) to process." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```