{ "openapi": "3.0.1", "info": { "title": "EU Company Register Lookup - VAT Validation & LEI Data", "description": "Resolve a company name or registration number against official European business registers, validate its VAT number through VIES, and attach its LEI. One schema for every country, no personal data.", "version": "0.1", "x-build-id": "Dhjha1J3lztTBuEIf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/eu_open_data~eu-company-register-lookup/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-eu_open_data-eu-company-register-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/eu_open_data~eu-company-register-lookup/runs": { "post": { "operationId": "runs-sync-eu_open_data-eu-company-register-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/eu_open_data~eu-company-register-lookup/run-sync": { "post": { "operationId": "run-sync-eu_open_data-eu-company-register-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": { "btwNummers": { "title": "VAT numbers to check", "type": "array", "description": "One VAT number per line, from any EU member state or Northern Ireland, e.g. NL810433941B01 or DE811907980. Spaces, dots and lowercase are fine; GR is converted to EL. When you fill this in, the register search below is skipped. Up to 1,000 numbers per run; allow roughly 1 to 3 numbers per second, and raise the run timeout for long lists. Only definitive answers (valid or invalid) are billed.", "items": { "type": "string" } }, "zoekterm": { "title": "Company name or registration number", "type": "string", "description": "Name, or a national registration number (SIREN, Norwegian org. number, Finnish business ID, UK company number, Polish KRS number), to look up across the selected registers. Used only when the VAT list above is empty.", "default": "equinor" }, "landen": { "title": "Countries", "type": "array", "description": "Which official registers to query. Poland's KRS can only be searched by KRS number, not by name.", "items": { "type": "string", "enum": [ "FR", "NO", "FI", "GB", "PL" ], "enumTitles": [ "France (RNE/SIRENE)", "Norway (Brreg)", "Finland (PRH/YTJ)", "United Kingdom (Companies House)", "Poland (KRS, by KRS number)" ] }, "default": [ "FR", "NO", "FI", "GB", "PL" ] }, "maxPerLand": { "title": "Max results per country", "minimum": 1, "maximum": 25, "type": "integer", "description": "Upper bound per register. Also caps the cost, since billing is per resolved company.", "default": 10 }, "btwControle": { "title": "Validate VAT numbers (VIES)", "type": "boolean", "description": "Check each EU VAT number against the European Commission's VIES service.", "default": true }, "leiKoppeling": { "title": "Match LEI codes (GLEIF)", "type": "boolean", "description": "Attach the global LEI identifier where one exists.", "default": true } } }, "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 } } } } } } } } } }