{ "openapi": "3.0.1", "info": { "title": "UK Companies House Search: Companies by SIC, Postcode, Date", "description": "Search every live UK company on the Companies House register by SIC code, incorporation date, postcode, town, name or status, or look up company numbers and names. Address, SIC, accounts and charges data. No API key. No officers, directors or owners.", "version": "0.1", "x-build-id": "0kRHap4nYqJTpfcgr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/itayozer9~uk-companies-house-companies/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-itayozer9-uk-companies-house-companies", "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/itayozer9~uk-companies-house-companies/runs": { "post": { "operationId": "runs-sync-itayozer9-uk-companies-house-companies", "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/itayozer9~uk-companies-house-companies/run-sync": { "post": { "operationId": "run-sync-itayozer9-uk-companies-house-companies", "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": { "sicCodes": { "title": "SIC codes (industry)", "type": "array", "description": "Companies with any of these SIC codes. A short code is a prefix: \"62\" is all of 62000 to 62999 (computer programming and IT), \"620\" narrows it, \"62020\" is one exact code. Up to 200 codes.", "items": { "type": "string" } }, "incorporatedFrom": { "title": "Incorporated on or after", "type": "string", "description": "Date like 2026-09-01. Use it with \"Incorporated on or before\" to get the companies registered in a month: new-company leads." }, "incorporatedTo": { "title": "Incorporated on or before", "type": "string", "description": "Date like 2026-09-30." }, "postcodes": { "title": "Postcodes (registered office)", "type": "array", "description": "Postcode area, district, sector or full postcode: \"M\" is all of Manchester's M1 to M99, \"EC1V\" one district, \"SW1\" covers SW1A to SW1Y, \"SW1A 1\" is a sector, \"SW1A 1AA\" one postcode (the space is optional). Up to 500.", "items": { "type": "string" } }, "towns": { "title": "Post towns (registered office)", "type": "array", "description": "Post towns as Companies House stores them, for example LONDON, MANCHESTER, GLASGOW. Case does not matter. Up to 500.", "items": { "type": "string" } }, "nameKeywords": { "title": "Words in the company name", "maxLength": 200, "type": "string", "description": "Every word must appear in the name as a whole word, for example \"bakery\" or \"green energy\". End a word with * to match its start: \"tech*\" finds TECH, TECHNOLOGY, TECHNICAL." }, "statuses": { "title": "Company status", "type": "array", "description": "Keep only these statuses. Empty keeps all. The snapshot holds live companies only: dissolved companies are not in it.", "items": { "type": "string", "enum": [ "Active", "Active - Proposal to Strike off", "Liquidation", "In Administration", "Voluntary Arrangement", "Live but Receiver Manager on at least one charge", "RECEIVERSHIP", "ADMINISTRATION ORDER", "ADMINISTRATIVE RECEIVER", "In Administration/Administrative Receiver", "In Administration/Receiver Manager", "RECEIVER MANAGER / ADMINISTRATIVE RECEIVER", "VOLUNTARY ARRANGEMENT / ADMINISTRATIVE RECEIVER", "VOLUNTARY ARRANGEMENT / RECEIVER MANAGER" ] } }, "companyTypes": { "title": "Company type", "type": "array", "description": "Keep only these types. Empty keeps all.", "items": { "type": "string", "enum": [ "Private Limited Company", "Public Limited Company", "Limited Liability Partnership", "Limited Partnership", "Community Interest Company", "PRI/LTD BY GUAR/NSC (Private, limited by guarantee, no share capital)", "PRI/LBG/NSC (Private, Limited by guarantee, no share capital, use of 'Limited' exemption)", "Private Unlimited Company", "Charitable Incorporated Organisation", "Scottish Charitable Incorporated Organisation", "Scottish Partnership", "Registered Society", "Overseas Entity", "Investment Company with Variable Capital", "Royal Charter Company", "Other company type" ] } }, "excludeDormant": { "title": "Skip dormant companies", "type": "boolean", "description": "Leave out companies that file dormant accounts or use SIC 99999 (dormant company).", "default": false }, "companyNumbers": { "title": "Look up company numbers", "type": "array", "description": "Company numbers to look up instead of searching, for example 00445790 or SC123456 (leading zeros may be left out). Results keep your order. Up to 10,000. Numbers not in the snapshot, and entries that are not company numbers, are listed in the log and cost nothing. Other filters still apply.", "items": { "type": "string" } }, "companyNames": { "title": "Look up exact company names", "type": "array", "description": "Company names to match to their company number. Matching ignores case, punctuation, \"&\" versus \"and\" and Ltd versus Limited. Up to 10,000. Names with no match are listed in the log and cost nothing. Use either numbers or names in one run.", "items": { "type": "string" } }, "maxItems": { "title": "Max companies", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Most companies to return, newest incorporation first (1 to 50,000). Default: 100 for a search, or one per lookup. You pay only for companies returned." } } }, "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 } } } } } } } } } }