{ "openapi": "3.0.1", "info": { "title": "European Company Registers (UK, Norway, Finland, Czechia)", "description": "Search the official company registers of the UK (Companies House), Norway, Finland and Czechia by name or register id; the UK also by SIC code, postcode, incorporation date and status. One row per company: legal form, status, industry code, municipality. No officers, no sole traders. No API key.", "version": "0.1", "x-build-id": "mNgv3AlVErpDCrW3b" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/darikami~european-company-registers/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-darikami-european-company-registers", "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/darikami~european-company-registers/runs": { "post": { "operationId": "runs-sync-darikami-european-company-registers", "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/darikami~european-company-registers/run-sync": { "post": { "operationId": "run-sync-darikami-european-company-registers", "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": { "query": { "title": "Company name", "type": "string", "description": "Words of a company name, such as \"equinor\" or \"skoda auto\". Each chosen register searches its own names (Finland also former and auxiliary names; the UK: every word in the current name). Leave empty to look up register ids only, or to search the UK by its filters below." }, "registerIds": { "title": "Register ids", "type": "array", "description": "Ids to look up, up to 1,000, from any of the four registers: a Norwegian organisation number (9 digits, 923609016 or NO923609016MVA), a Finnish business id (0112038-9 or FI01120389), a Czech IČO (8 digits, 00177041 or CZ00177041) or a UK company number (SC123456, OC301540; one of 8 digits as GB-COH-01285743, because 8 digits alone are a Czech IČO). The country follows from the format; NO, FI and CZ check digits are verified.", "items": { "type": "string" } }, "countries": { "title": "Countries to search", "type": "array", "description": "The registers the search runs in: NO (Brønnøysund), FI (PRH), CZ (ARES) and GB (Companies House). GB reads Companies House's monthly file of all live UK companies (about 470 MB) - a GB search that reads the whole file takes about 7 minutes at the default 1,024 MB (faster with more memory), so GB is not in the default. Register ids are always looked up in their own register.", "items": { "type": "string", "enum": [ "NO", "FI", "CZ", "GB" ], "enumTitles": [ "Norway (Brønnøysund)", "Finland (PRH / YTJ)", "Czechia (ARES)", "United Kingdom (Companies House)" ] }, "default": [ "NO", "FI", "CZ" ] }, "maxCompanies": { "title": "Max companies per country", "minimum": 1, "maximum": 1000, "type": "integer", "description": "The search stops in each register after this many companies (1 to 1,000). Companies looked up by id do not count. Each company is one charged event, once per run.", "default": 50 }, "activeOnly": { "title": "Active companies only", "type": "boolean", "description": "On: the search leaves out ceased, bankrupt, liquidating and restructuring companies (UK: also those the register proposes to strike off). Register id lookups always return the company with its status. \"UK statuses\" below replaces this for the UK.", "default": true }, "ukSicCodes": { "title": "UK: SIC codes", "type": "array", "description": "UK SIC 2007 codes or their first digits, such as 62012 (software development) or 62 (all IT services). A company matches when one of its up to 4 SIC codes starts so.", "items": { "type": "string" } }, "ukPostcodes": { "title": "UK: postcode prefixes", "type": "array", "description": "The registered office's postcode: an area (M, SW), a district (SW1A, EC1, M1) or a sector (SW1A 1). An area takes only its own districts (M is not ME); a district takes its lettered sub-districts (EC1 takes EC1V, not EC10).", "items": { "type": "string" } }, "ukIncorporatedFrom": { "title": "UK: incorporated from", "type": "string", "description": "Incorporated on or after this day (YYYY-MM-DD)." }, "ukIncorporatedTo": { "title": "UK: incorporated to", "type": "string", "description": "Incorporated on or before this day (YYYY-MM-DD)." }, "ukLegalForms": { "title": "UK: legal forms", "type": "array", "description": "Only these legal forms. Empty: all.", "items": { "type": "string", "enum": [ "LTD", "LTD-GUAR", "LTD-GUAR-EX", "LTD-S30", "UNLTD", "PLC", "OLD-PLC", "LLP", "LP", "SP", "CIC", "CIO", "SCIO", "RS", "IPS", "RC", "ICVC", "PCC", "UKEIG", "UKS", "FE", "OE", "OTHER" ], "enumTitles": [ "Private limited company", "Private company limited by guarantee", "Limited by guarantee, exempt from \"Limited\"", "Private limited company, section 30", "Private unlimited company", "Public limited company", "Old public company", "Limited liability partnership", "Limited partnership", "Scottish partnership", "Community interest company", "Charitable incorporated organisation", "Scottish charitable incorporated organisation", "Registered society", "Industrial and provident society", "Royal charter company", "Investment company with variable capital", "Protected cell company", "UK economic interest grouping", "UK Societas", "Further education or sixth form college corporation", "Overseas entity", "Other (mostly overseas companies)" ] } }, "ukStatuses": { "title": "UK: statuses", "type": "array", "description": "Only companies with these statuses, such as liquidation for insolvency work. Empty: \"Active companies only\" decides.", "items": { "type": "string", "enum": [ "active", "striking-off", "liquidation", "reorganisation", "receivership" ], "enumTitles": [ "Active", "Proposed to be struck off", "In liquidation", "In administration or a voluntary arrangement", "In receivership" ] } } } }, "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 } } } } } } } } } }