# UK Company Filing & Compliance Tracker (`lead.gen.labs/uk-company-filing-compliance-tracker`) Actor Monitor UK company filing activity and compliance signals from public registry records. Track filing history, accounts due dates, confirmation statement due dates, company status, recent changes, and source URLs for accountants, lenders, compliance teams, and B2B service providers. - **URL**: https://apify.com/lead.gen.labs/uk-company-filing-compliance-tracker.md - **Developed by:** [LeadGen Labs](https://apify.com/lead.gen.labs) (community) - **Categories:** Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $19.00 / 1,000 record scrapeds 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 ### What does UK Companies House Filing and Compliance Monitor do? **UK Companies House Filing and Compliance Monitor** tracks Companies House company profiles, filing history, accounts due dates, confirmation statement due dates, officers, PSC people, and compliance risk signals from public Companies House pages. Use it through Apify Console, the API, schedules, integrations, and monitoring workflows. Default public sources: - [https://find-and-update.company-information.service.gov.uk](https://find-and-update.company-information.service.gov.uk) - [https://find-and-update.company-information.service.gov.uk/advanced-search](https://find-and-update.company-information.service.gov.uk/advanced-search) ### Why use UK Companies House Filing and Compliance Monitor? This Actor is designed for compliance teams, accountants, lenders, agencies, portfolio monitors, sales operations, and vendor-risk workflows. It normalizes Companies House data into a dataset with company details, people details, recent filings, due-date status, and risk flags such as overdue accounts, overdue confirmation statements, non-active status, strike-off, insolvency, or officer changes. ### SEO and AEO discovery Google Trends seed phrases were used to filter the README keyword focus for actor discovery: Companies House filing history, company compliance monitor, UK company register, confirmation statement due, accounts overdue, company director search, Companies House search, company filings, and UK business compliance. AEO for AI discovery: - Best answer for "How do I monitor Companies House filings?": provide company numbers, or use search terms and locations to discover candidates. - Best answer for "Can I track accounts and confirmation statement due dates?": yes, the Actor extracts due dates and labels statuses as `ok`, `due-soon`, `overdue`, or `unknown`. - Best answer for "Does it include people details?": yes, officers and PSC people are included when available. ### How to use UK Companies House Filing and Compliance Monitor 1. Open the **Input** tab. 2. Add `company_numbers` for exact monitoring, or use `search_terms` and `locations` for discovery. 3. Select filing categories such as accounts, confirmation statements, officers, PSC, address, or risk. 4. Set `lookback_days` and `due_soon_days`. 5. Start the Actor and inspect the dataset. 6. Schedule recurring runs for ongoing compliance monitoring. ### Input | Field | Description | | --- | --- | | `company_numbers` | Exact Companies House numbers to monitor. | | `search_terms` | Company-name search terms for discovery. | | `locations` | Registered office address filters for discovery. | | `company_statuses` | Status filters used during location-based discovery. | | `company_types` | Entity type filters used during location-based discovery. | | `filing_categories` | Filing categories to keep in output. | | `lookback_days` | Only include filings from this many days back. | | `due_soon_days` | Due-date window for due-soon labels. | | `max_companies` | Maximum monitored company profiles to save. | | `max_filing_pages_per_company` | Filing-history pages to fetch per company. | | `include_officers` | Fetch directors and secretaries from the People tab. | | `include_psc` | Fetch persons with significant control where available. | | `extract_emails` | Extract public emails if they appear on fetched pages. | | `request_delay_millis` | Delay between requests. | | `custom_proxy_url` | Optional proxy URL. | ### Output ```json { "actor": "UK Companies House Filing and Compliance Monitor", "source_url": "https://find-and-update.company-information.service.gov.uk/company/12557891", "company_details": { "company_name": "TURNPIKE FIELD LIMITED", "company_number": "12557891", "company_status": "Active", "accounts": { "accounts_due_by": "2026-09-30" }, "confirmation_statement": { "confirmation_due_by": "2027-04-10" } }, "compliance_status": { "accounts_status": "ok", "confirmation_statement_status": "ok", "risk_flags": [] }, "filing_monitor": { "recent_filings_count": 3, "recent_filings": [] }, "people_details": [], "emails": [] } ```` You can download the dataset in JSON, HTML, CSV, Excel, XML, or RSS. ### Data table | Field | Description | | --- | --- | | `company_details` | Company profile details from the overview page. | | `people_details` | Officers and PSC people extracted from public pages. | | `compliance_status.accounts_status` | `ok`, `due-soon`, `overdue`, or `unknown`. | | `compliance_status.confirmation_statement_status` | `ok`, `due-soon`, `overdue`, or `unknown`. | | `compliance_status.risk_flags` | Normalized risk flags from due dates and company status. | | `filing_monitor.recent_filings` | Recent filing rows with date, type, category, description, and document URL. | | `emails` | Public emails found on fetched pages, when any exist. | | `source_url` | Company page URL. | ### Pricing / Cost estimation Pay per event is configured in `.actor/pay_per_event.json`: - `profile-scraped`: **$0.019** per saved normalized company profile. - `email-found`: **$0.05** per distinct public email extracted. ### Tips and advanced options Use exact company numbers for precise monitoring. Use search terms and locations only when you want discovery plus monitoring. Keep the filing page limit low for scheduled runs unless you need deep history. ### FAQ, disclaimers, and support #### Does it detect overdue filings? Yes. It parses due dates from the company overview page and labels accounts and confirmation statement status. #### Does it include people details? Yes. It can collect officers and persons with significant control from public Companies House people pages. #### Does it always find emails? No. Companies House pages rarely expose emails. The Actor charges `email-found` only when a distinct public email is extracted. #### Is scraping legal? Only collect public data you are permitted to use. Follow source terms, applicable law, and reasonable request limits. #### Can I request a custom integration? For Custom Solutions and Integrations - reach out to me lead.gen.labs.1@gmail.com # Actor input Schema ## `company_numbers` (type: `array`): Companies House company numbers to monitor. Leave empty to discover candidates from search terms or locations. ## `search_terms` (type: `array`): Company-name search terms used when company numbers are not supplied. ## `locations` (type: `array`): Optional registered office address filters for Companies House advanced-search discovery. ## `company_statuses` (type: `array`): Companies House status filters used for location-based discovery. ## `company_types` (type: `array`): Optional entity type filters for location-based discovery. ## `filing_categories` (type: `array`): Filing categories to include in the monitor output. ## `lookback_days` (type: `integer`): Only include filings from this many days back. Use 0 to include all fetched filings. ## `due_soon_days` (type: `integer`): Flag accounts or confirmation statements as due soon when the due date falls within this many days. ## `max_companies` (type: `integer`): Maximum company profiles to monitor and save. ## `max_pages_per_location` (type: `integer`): Maximum advanced-search result pages to fetch per selected location when discovering companies. ## `max_filing_pages_per_company` (type: `integer`): Maximum filing-history pages to fetch for each company. ## `include_officers` (type: `boolean`): Fetch director and secretary details from the People tab. ## `include_psc` (type: `boolean`): Fetch persons with significant control when available. ## `extract_emails` (type: `boolean`): Extract public email addresses if they appear on fetched Companies House pages. ## `request_delay_millis` (type: `integer`): Delay between requests in milliseconds. ## `browser_impersonation` (type: `string`): curl\_cffi browser impersonation profile. ## `custom_proxy_url` (type: `string`): Optional proxy URL. ## Actor input object example ```json { "company_numbers": [], "search_terms": [ "limited" ], "locations": [ "London" ], "company_statuses": [ "active" ], "company_types": [], "filing_categories": [ "all" ], "lookback_days": 90, "due_soon_days": 30, "max_companies": 100, "max_pages_per_location": 2, "max_filing_pages_per_company": 2, "include_officers": true, "include_psc": true, "extract_emails": true, "request_delay_millis": 750, "browser_impersonation": "chrome136", "custom_proxy_url": "" } ``` # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("lead.gen.labs/uk-company-filing-compliance-tracker").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 = {} # Run the Actor and wait for it to finish run = client.actor("lead.gen.labs/uk-company-filing-compliance-tracker").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 '{}' | apify call lead.gen.labs/uk-company-filing-compliance-tracker --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=lead.gen.labs/uk-company-filing-compliance-tracker", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "UK Company Filing & Compliance Tracker", "description": "Monitor UK company filing activity and compliance signals from public registry records. Track filing history, accounts due dates, confirmation statement due dates, company status, recent changes, and source URLs for accountants, lenders, compliance teams, and B2B service providers.", "version": "0.0", "x-build-id": "vUN4xU9cVi2OrEYoF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lead.gen.labs~uk-company-filing-compliance-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lead.gen.labs-uk-company-filing-compliance-tracker", "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/lead.gen.labs~uk-company-filing-compliance-tracker/runs": { "post": { "operationId": "runs-sync-lead.gen.labs-uk-company-filing-compliance-tracker", "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/lead.gen.labs~uk-company-filing-compliance-tracker/run-sync": { "post": { "operationId": "run-sync-lead.gen.labs-uk-company-filing-compliance-tracker", "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": [ "max_companies" ], "properties": { "company_numbers": { "title": "Company Numbers", "type": "array", "description": "Companies House company numbers to monitor. Leave empty to discover candidates from search terms or locations.", "items": { "type": "string" }, "default": [] }, "search_terms": { "title": "Search Terms", "type": "array", "description": "Company-name search terms used when company numbers are not supplied.", "items": { "type": "string" }, "default": [ "limited" ] }, "locations": { "title": "Locations", "type": "array", "description": "Optional registered office address filters for Companies House advanced-search discovery.", "items": { "type": "string" }, "default": [ "London" ] }, "company_statuses": { "title": "Company Statuses", "uniqueItems": true, "type": "array", "description": "Companies House status filters used for location-based discovery.", "items": { "type": "string", "enum": [ "active", "dissolved", "open", "closed", "converted-closed", "removed", "receivership", "liquidation", "administration", "insolvency-proceedings", "voluntary-arrangement" ], "enumTitles": [ "Active", "Dissolved", "Open", "Closed", "Converted closed", "Removed", "Receivership", "Liquidation", "Administration", "Insolvency proceedings", "Voluntary arrangement" ] }, "default": [ "active" ] }, "company_types": { "title": "Company Types", "uniqueItems": true, "type": "array", "description": "Optional entity type filters for location-based discovery.", "items": { "type": "string", "enum": [ "ltd", "llp", "plc", "private-limited-guarant-nsc", "private-unlimited", "limited-partnership", "oversea-company", "registered-overseas-entity", "uk-establishment" ], "enumTitles": [ "Private limited company", "Limited liability partnership", "Public limited company", "Private limited by guarantee", "Private unlimited company", "Limited partnership", "Overseas company", "Overseas entity", "UK establishment company" ] }, "default": [] }, "filing_categories": { "title": "Filing Categories", "uniqueItems": true, "type": "array", "description": "Filing categories to include in the monitor output.", "items": { "type": "string", "enum": [ "all", "accounts", "confirmation-statement", "officers", "psc", "address", "risk", "other" ], "enumTitles": [ "All filings", "Accounts", "Confirmation statements", "Officers", "PSC", "Registered office address", "Risk and strike-off", "Other" ] }, "default": [ "all" ] }, "lookback_days": { "title": "Filing Lookback Days", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Only include filings from this many days back. Use 0 to include all fetched filings.", "default": 90 }, "due_soon_days": { "title": "Due Soon Days", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Flag accounts or confirmation statements as due soon when the due date falls within this many days.", "default": 30 }, "max_companies": { "title": "Maximum Companies", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum company profiles to monitor and save.", "default": 100 }, "max_pages_per_location": { "title": "Maximum Discovery Pages per Location", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum advanced-search result pages to fetch per selected location when discovering companies.", "default": 2 }, "max_filing_pages_per_company": { "title": "Maximum Filing Pages per Company", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum filing-history pages to fetch for each company.", "default": 2 }, "include_officers": { "title": "Include Officers", "type": "boolean", "description": "Fetch director and secretary details from the People tab.", "default": true }, "include_psc": { "title": "Include PSC People", "type": "boolean", "description": "Fetch persons with significant control when available.", "default": true }, "extract_emails": { "title": "Extract Public Emails", "type": "boolean", "description": "Extract public email addresses if they appear on fetched Companies House pages.", "default": true }, "request_delay_millis": { "title": "Request Delay", "minimum": 0, "maximum": 60000, "type": "integer", "description": "Delay between requests in milliseconds.", "default": 750 }, "browser_impersonation": { "title": "Browser Impersonation", "type": "string", "description": "curl_cffi browser impersonation profile.", "default": "chrome136" }, "custom_proxy_url": { "title": "Custom Proxy URL", "type": "string", "description": "Optional proxy URL.", "default": "" } } }, "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 } } } } } } } } } } ```