UK Companies House Company Feed (Unofficial)
Pricing
from $4.00 / 1,000 company saveds
UK company data from Companies House: status, type, SIC codes, accounts and confirmation dates, district-level address and optional filed-accounts financials. Keyless bulk mode, or bring your own API key. Company data only: no officers or PSCs. Not affiliated with Companies House.
You can access the UK Companies House Company Feed (Unofficial) programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "0.1", "x-build-id": "omPdFNkBmK2OEm76v" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/graylabs~uk-companies/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-graylabs-uk-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/graylabs~uk-companies/runs": { "post": { "operationId": "runs-sync-graylabs-uk-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/graylabs~uk-companies/run-sync": { "post": { "operationId": "run-sync-graylabs-uk-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": { "mode": { "title": "Mode", "enum": [ "bulk", "accounts", "api" ], "type": "string", "description": "bulk: filter the free monthly Companies House company snapshot (no key needed). accounts: headline figures from the latest free daily accounts file (no key needed). api: live Companies House API with your own free API key (lookups by company number, or advanced search; optional financials).", "default": "bulk" }, "nameContains": { "title": "Company name contains", "type": "array", "description": "Keep companies whose name contains any of these words (case-insensitive). API mode searches on the first entry only.", "default": [], "items": { "type": "string" } }, "sicCodes": { "title": "SIC codes or prefixes", "type": "array", "description": "SIC 2007 codes. In bulk mode prefixes work: 62 matches every 62xxx code. API search needs full 5-digit codes. Not available in accounts mode.", "default": [], "items": { "type": "string" } }, "postcodePrefixes": { "title": "Registered office postcode prefixes", "type": "array", "description": "E.g. EC1, M1, SW1A. Matches the start of the registered office postcode. Not available in accounts mode.", "default": [], "items": { "type": "string" } }, "companyTypes": { "title": "Company types", "type": "array", "description": "Keep rows whose company type contains any of these, e.g. Private Limited Company, PLC, Limited Liability Partnership, Community Interest Company.", "default": [], "items": { "type": "string" } }, "companyStatuses": { "title": "Company statuses", "type": "array", "description": "E.g. Active, Liquidation, Active - Proposal to Strike off. The bulk snapshot only contains live companies.", "default": [], "items": { "type": "string" } }, "incorporatedFrom": { "title": "Incorporated from (YYYY-MM-DD)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only companies incorporated on or after this date." }, "incorporatedTo": { "title": "Incorporated to (YYYY-MM-DD)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only companies incorporated on or before this date." }, "bulkParts": { "title": "Bulk file parts", "type": "array", "description": "The monthly snapshot is published in parts (currently 7, sorted by company name). Leave empty to read all parts in order, or pick parts, e.g. [1]. Reading stops as soon as Max results is reached.", "default": [] }, "maxScanRows": { "title": "Max rows to scan", "minimum": 1, "maximum": 10000000, "type": "integer", "description": "Safety cap on snapshot rows (or accounts files) read per run. The whole register is about 5.7 million rows; a filter that has to read all of it takes about 3 minutes.", "default": 6000000 }, "accountsFileDate": { "title": "Accounts file date (YYYY-MM-DD)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Accounts mode: which daily accounts file to read (published Tuesday to Saturday, kept for 60 days). Leave empty for the latest." }, "apiKey": { "title": "Your Companies House API key", "type": "string", "description": "API mode only. A free REST API key from developer.company-information.service.gov.uk. Stored encrypted by Apify as a secret input; this actor never logs or saves it. Requests are paced under the documented limit of 600 per 5 minutes." }, "companyNumbers": { "title": "Company numbers", "type": "array", "description": "API mode: look up these companies, e.g. 00000006, SC123456. Leave empty to use the name / SIC filters as an advanced search.", "default": [], "items": { "type": "string" } }, "includeFinancials": { "title": "Include financials (API mode)", "type": "boolean", "description": "Read headline figures from each company's latest electronically filed accounts. Costs about 3 extra API requests per company. Not every company files machine-readable accounts.", "default": false }, "maxApiRequests": { "title": "Max API requests", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Upper limit on Companies House API requests per run.", "default": 500 }, "addressDetail": { "title": "Registered office address detail", "enum": [ "district", "full" ], "type": "string", "description": "district (default): town, county, country and postcode district only. full: also address lines and full postcode, except for companies whose name looks like a person's name. Many small companies use a home address as the registered office.", "default": "district" }, "personNamedCompanies": { "title": "Companies named after a person", "enum": [ "flag", "exclude" ], "type": "string", "description": "flag: keep them with nameLooksPersonal = true and district-level address only. exclude: leave them out.", "default": "flag" }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many companies.", "default": 100 } } }, "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 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for UK Companies House Company Feed (Unofficial) from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: