{ "openapi": "3.0.1", "info": { "title": "UK Companies House Bulk Company Data - No API Key", "description": "Every live UK company from the official Companies House monthly snapshot: name, number, type, status, incorporation date, SIC, accounts/confirmation due dates, charges. Filter by name, SIC, status, type, town, postcode, date or number. No API key. Unofficial; not affiliated with Companies House.", "version": "0.1", "x-build-id": "Qxp8VGnms1lx652OM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jpopendata~uk-companies-house-bulk/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jpopendata-uk-companies-house-bulk", "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/jpopendata~uk-companies-house-bulk/runs": { "post": { "operationId": "runs-sync-jpopendata-uk-companies-house-bulk", "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/jpopendata~uk-companies-house-bulk/run-sync": { "post": { "operationId": "run-sync-jpopendata-uk-companies-house-bulk", "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", "properties": { "companyNameKeywords": { "title": "Company name keywords", "type": "array", "description": "Optional. Words or phrases in the company name (whole words, any case), e.g. \"bakery\", \"property management\", \"b&q\". End a word with * to match any word starting with it: \"tech*\" finds TECH, TECHNOLOGY, TECHNICAL. A company matches if its name contains ANY of them.", "default": [], "items": { "type": "string" } }, "sicCodes": { "title": "SIC codes", "type": "array", "description": "Optional. UK SIC 2007 codes or prefixes (2 to 5 digits), e.g. \"62012\" (business and domestic software development), \"6201\" (every code starting 6201), \"56\" (food and beverage service activities), \"41\" (construction of buildings). A company matches if ANY of its up to 4 SIC codes starts with one of them.", "default": [], "items": { "type": "string" } }, "statuses": { "title": "Company statuses", "type": "array", "description": "Optional. active, proposal-to-strike-off, liquidation, administration, receivership, voluntary-arrangement, other. Words such as \"strike off\" or \"insolvency\" (= liquidation + administration + receivership + voluntary-arrangement) also work. The snapshot lists LIVE companies only: dissolved companies are never in it. Empty = every status.", "default": [], "items": { "type": "string" } }, "companyTypes": { "title": "Company types", "type": "array", "description": "Optional. ltd, plc, guarantee (limited by guarantee), unlimited, cic, llp, lp, scottish-partnership, cio (charitable incorporated organisation), overseas-entity, registered-society, icvc, royal-charter, eeig, se, other (incl. overseas companies). Plain words such as \"limited\", \"public\" or \"partnership\" also work. Empty = every type.", "default": [], "items": { "type": "string" } }, "incorporatedFrom": { "title": "Incorporated from", "type": "string", "description": "Optional. Earliest incorporation date: YYYY-MM-DD (\"2026-09-01\"), UK DD/MM/YYYY (\"01/09/2026\"), a month (\"2026-09\" = from 1 September) or a year (\"2025\"). The snapshot covers companies registered up to the end of the month before its date, so new incorporations appear once a month.", "default": "" }, "incorporatedTo": { "title": "Incorporated to", "type": "string", "description": "Optional. Latest incorporation date (inclusive), same forms as above; a month (\"2026-09\") means up to its last day.", "default": "" }, "postTowns": { "title": "Post towns (registered office)", "type": "array", "description": "Optional. Post town of the registered office as written in the register, e.g. \"London\", \"Manchester\", \"St Albans\", \"Newcastle upon Tyne\" (case, dots and hyphens are ignored). Counties and countries are not post towns. If a town gives few results, try postcode districts instead.", "default": [], "items": { "type": "string" } }, "postcodeDistricts": { "title": "Postcode districts (registered office)", "type": "array", "description": "Optional. The first half of the registered office postcode (outward code), e.g. \"M1\", \"RG1\", \"EC2V\", \"SW1A\"; a district ending in a digit such as \"SW1\" also covers SW1A..SW1Y. Postcode areas (1-2 letters such as \"M\", \"LS\" or \"SW\") match every district in the area. A full postcode is reduced to its district; full postcodes are never output.", "default": [], "items": { "type": "string" } }, "companyNumbers": { "title": "Company numbers", "type": "array", "description": "Optional. Companies House numbers to look up, e.g. \"00445790\", \"SC668770\", \"OC333419\" (leading zeros may be left out). The run stops as soon as all of them are found; if any is missing (dissolved companies, or registered after the snapshot date) the whole snapshot is read (about 25 minutes) and the missing numbers are listed in the RUN_SUMMARY record. Up to 50,000 numbers per run.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Stop after this many companies (1..1,000,000). Rows come in company-name order, so a small number returns the first matches alphabetically and usually finishes in seconds. A search that never reaches this number has to read the whole snapshot (about 490 MB of ZIP files), which took about 25 minutes in October 2026 because the files download slowly from the Companies House CDN.", "default": 20 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Not needed: the Companies House download site answers Apify datacenter IPs directly. Leave off unless you have a reason to route the download through a proxy (one sticky session per run, no rotation).", "default": { "useApifyProxy": false } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }