{
"openapi": "3.0.1",
"info": {
"title": "EU Company Registers API (FR, NO, FI, CZ, IE, PL)",
"description": "European company registry API for six official registers: Ireland, Norway, Finland, France, Czechia and Poland. Lookup, search and new companies. No API key.",
"version": "0.1",
"x-build-id": "XtfuH2thJrxmyNeBL"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/yourevenings~eu-company-registers/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-yourevenings-eu-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/yourevenings~eu-company-registers/runs": {
"post": {
"operationId": "runs-sync-yourevenings-eu-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/yourevenings~eu-company-registers/run-sync": {
"post": {
"operationId": "run-sync-yourevenings-eu-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": {
"mode": {
"title": "Mode",
"enum": [
"lookup",
"search",
"newCompanies"
],
"type": "string",
"description": "Look up returns the companies you list by country and register ID. Search finds companies by name in each country's register (FR, NO, FI, CZ, IE). Newly registered lists companies registered in a date range (NO, FI, IE).",
"default": "lookup"
},
"companies": {
"title": "Companies",
"type": "array",
"description": "For Look up: up to 500 entries as COUNTRY:ID. FR = SIREN (9 digits, or a 14-digit SIRET), NO = organisasjonsnummer (9 digits), FI = Business ID (1234567-8), CZ = IČO (8 digits), IE = CRO company number, PL = KRS number (up to 10 digits). Unknown or invalid IDs get a free status row.",
"items": {
"type": "string"
}
},
"defaultCountry": {
"title": "Default country",
"enum": [
"FR",
"NO",
"FI",
"CZ",
"IE",
"PL"
],
"type": "string",
"description": "For Look up: country to use for entries with no COUNTRY: prefix."
},
"name": {
"title": "Company name",
"type": "string",
"description": "For Search: the company name or part of it (at least 2 characters)."
},
"countries": {
"title": "Countries",
"type": "array",
"description": "For Search and Newly registered: which registers to query. Empty = every register that supports the mode. A country that doesn't support the mode gets a free not_supported row.",
"items": {
"type": "string",
"enum": [
"FR",
"NO",
"FI",
"CZ",
"IE",
"PL"
],
"enumTitles": [
"France",
"Norway",
"Finland",
"Czechia",
"Ireland",
"Poland"
]
}
},
"activeOnly": {
"title": "Active companies only",
"type": "boolean",
"description": "For Search and Newly registered: leave out closed, dissolved or struck-off companies. FR, NO and IE filter at the register; for every country, rows whose status is inactive are dropped before charging and counted in a free skipped_inactive row. Companies in liquidation or bankruptcy are kept.",
"default": false
},
"registeredWithinDays": {
"title": "Registered in the last N days",
"minimum": 0,
"maximum": 366,
"type": "integer",
"description": "For Newly registered: date range ending today. Ignored when 'Registered since' is set.",
"default": 7
},
"registeredSince": {
"title": "Registered since",
"type": "string",
"description": "For Newly registered: start date, YYYY-MM-DD."
},
"registeredUntil": {
"title": "Registered until",
"type": "string",
"description": "For Newly registered: end date, YYYY-MM-DD. Default today."
},
"maxResults": {
"title": "Max records (whole run)",
"minimum": 0,
"type": "integer",
"description": "Stop after this many company records across all countries. 0 means no limit. You are charged per company record returned.",
"default": 50
},
"maxResultsPerCountry": {
"title": "Max records per country",
"minimum": 0,
"type": "integer",
"description": "Stop each country after this many company records. 0 means no limit.",
"default": 25
},
"monitorMode": {
"title": "Monitor mode (only new or changed records)",
"type": "boolean",
"description": "Remember a fingerprint of each company (name, legal form, status, address, activity, website, VAT ID) and, on later runs, return only companies that are new or changed, with the changed fields and their old values. Schedule it to watch a list of companies or new registrations.",
"default": false
},
"emitBaselineOnFirstRun": {
"title": "Return records on the first monitor run",
"type": "boolean",
"description": "Off: the first monitor run only records what exists (no rows, no charges).",
"default": true
},
"stateStoreName": {
"title": "Monitor state store name",
"type": "string",
"description": "Named key-value store for monitor state. Use a different name per watch list.",
"default": "eu-company-registers-monitor"
}
}
},
"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
}
}
}
}
}
}
}
}
}
}