{ "openapi": "3.0.1", "info": { "title": "Company Registry Lookup – Companies House & Europe", "description": "Company lookup from official registries: UK Companies House, Spain's BORME filings, France's Sirene/RNE, Finland's PRH and Norway's Brønnøysund register. Search by name or company number, or get daily feeds of new companies. One schema, source links, no scraping. $2 per 1,000 companies.", "version": "0.1", "x-build-id": "BlFBtg9AkYSA8FcVP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/oldjard~company-registry-lookup/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-oldjard-company-registry-lookup", "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/oldjard~company-registry-lookup/runs": { "post": { "operationId": "runs-sync-oldjard-company-registry-lookup", "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/oldjard~company-registry-lookup/run-sync": { "post": { "operationId": "run-sync-oldjard-company-registry-lookup", "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": { "country": { "title": "Country", "enum": [ "ES", "FR", "FI", "NO", "GB" ], "type": "string", "description": "The registry to read. Spain returns registry filings (history) by publication date. France, Finland, Norway and the United Kingdom return each company's current register record; Finland, Norway and the United Kingdom can also list the companies registered (UK: incorporated) in a date range (France cannot: look companies up by name or SIREN).", "default": "ES" }, "companies": { "title": "Companies to look up (optional)", "type": "array", "description": "Company names (accents, punctuation and the legal form are ignored, e.g. \"Reveni SL\", \"Nokia\", \"Equinor\") or registry IDs: Spain: registry sheet as BORME prints it (\"M 672338\"); France: SIREN or SIRET (\"552032534\"); Finland: Business ID (\"0112038-9\"); Norway: organisation number (\"923609016\"); United Kingdom: company number (\"00445790\", \"SC123456\"). Leave empty for a feed: Spain's filings in the date range, or the companies registered in the range in Finland, Norway and the United Kingdom.", "items": { "type": "string" } }, "matchMode": { "title": "Name matching", "enum": [ "exact", "contains" ], "type": "string", "description": "Exact: \"Reveni\" matches \"REVENI SL\" only. Contains: \"Reveni\" also matches \"REVENI GLOBAL SL\".", "default": "exact" }, "dateFrom": { "title": "From date", "type": "string", "description": "First publication date to read: YYYY-MM-DD, or relative such as \"7 days\", \"3 months\", \"1 year\". Spain has data from 2009. For France, Finland, Norway and the United Kingdom the dates apply to feeds only (registration date); a lookup returns the current record. Default: 7 days ago." }, "dateTo": { "title": "To date", "type": "string", "description": "Last publication date to read (inclusive): YYYY-MM-DD, \"today\", \"yesterday\" or e.g. \"7 days\". Default: today." }, "regions": { "title": "Provinces (optional)", "type": "array", "description": "Spain only: read only these provinces (where the company is registered). Empty = all of Spain. Choosing provinces makes long date ranges fast: one province reads one page per publication day. Leave empty for other countries.", "items": { "type": "string", "enum": [ "01", "02", "03", "04", "05", "06", "07", "08", "09", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31", "32", "33", "34", "35", "36", "37", "38", "39", "40", "41", "42", "43", "44", "45", "46", "47", "48", "49", "50", "51", "52" ], "enumTitles": [ "Araba/Álava", "Albacete", "Alicante/Alacant", "Almería", "Ávila", "Badajoz", "Illes Balears", "Barcelona", "Burgos", "Cáceres", "Cádiz", "Castellón/Castelló", "Ciudad Real", "Córdoba", "A Coruña", "Cuenca", "Girona", "Granada", "Guadalajara", "Gipuzkoa", "Huelva", "Huesca", "Jaén", "León", "Lleida", "La Rioja", "Lugo", "Madrid", "Málaga", "Murcia", "Navarra", "Ourense", "Asturias", "Palencia", "Las Palmas", "Pontevedra", "Salamanca", "Santa Cruz de Tenerife", "Cantabria", "Segovia", "Sevilla", "Soria", "Tarragona", "Teruel", "Toledo", "Valencia/València", "Valladolid", "Bizkaia", "Zamora", "Zaragoza", "Ceuta", "Melilla" ] } }, "actTypes": { "title": "Only filings with these acts (optional)", "type": "array", "description": "Spain only: keep only filings that contain at least one of these acts. For a new-companies feed choose \"New companies\". Empty = all acts. (A Finland, Norway or United Kingdom feed already lists newly registered companies.)", "items": { "type": "string", "enum": [ "incorporation", "appointment", "resignation", "revocation", "re-election", "address-change", "name-change", "purpose-change", "bylaws-change", "capital-increase", "capital-reduction", "sole-shareholder", "merger", "demerger", "transformation", "dissolution", "extinction", "insolvency", "registry-closure", "registry-reopening", "correction", "other" ], "enumTitles": [ "New companies (incorporations)", "Appointments", "Resignations / removals", "Revoked powers", "Re-elections", "Change of registered address", "Change of name", "Change of business purpose", "Bylaw changes", "Capital increase", "Capital reduction", "Sole-shareholder changes", "Mergers", "Demergers / spin-offs", "Change of legal form", "Dissolution", "Extinction (struck off)", "Insolvency proceedings", "Registry sheet closed", "Registry sheet reopened / reactivated", "Corrections", "Other acts" ] } }, "outputMode": { "title": "Output", "enum": [ "companies", "filings" ], "type": "string", "description": "Companies: one record per company. For Spain, with its latest name, status, address, capital and the filings found; filings output (Spain only) writes one row per published filing as the scan goes. France, Finland and Norway always return one row per company.", "default": "companies" }, "includeOfficers": { "title": "Include officer names (personal data)", "type": "boolean", "description": "Off (default): positions are reported as role and count only, names of natural persons are left out (company names in those roles are kept), and sole traders are skipped (Spain: sole-trader entries and free-text acts that can name people; France: entrepreneurs individuels; Norway: enkeltpersonforetak). Birth dates are never output. Turn on only if you have a lawful basis under the GDPR to process these names (see the README). United Kingdom: officers are read only when this is on; corporate officers are then named too, and officer addresses are never output. Finland's open data has no officers or sole traders.", "default": false }, "companiesHouseApiKey": { "title": "Companies House API key (needed for the UK)", "type": "string", "description": "United Kingdom only, and required for it. Your own free Companies House API key: create an account and a REST key at https://developer.company-information.service.gov.uk/ (about 5 minutes, no payment, no ID check; see the README). Stored as a secret and sent only to Companies House. Your key gets the full Companies House rate limit (600 requests per 5 minutes) to itself. Not needed for Spain, France, Finland or Norway." }, "maxResults": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Stop after this many rows (companies or filings). 0 = no limit. Default 100 keeps a first run cheap; 0 = no limit.", "default": 100 }, "failOnError": { "title": "Fail the run if any page fails", "type": "boolean", "description": "For health checks and pipelines: any page that cannot be read fails the run instead of being listed in the summary.", "default": 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 } } } } } } } } } }