{ "openapi": "3.0.1", "info": { "title": "EU Company Verification (KYB): VIES VAT, LEI, SIREN", "description": "KYB (know your business) company verification for Europe: VAT validation in live VIES, LEI lookup (GLEIF), SIREN/SIRET and org numbers checked in official business registries (France, Norway, Finland, Czechia), plus BODACC insolvency. One verdict per company with reasons. MCP-ready.", "version": "1.0", "x-build-id": "BMc8vnFWo9gf46JGH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ostrata~eu-company-check/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ostrata-eu-company-check", "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/ostrata~eu-company-check/runs": { "post": { "operationId": "runs-sync-ostrata-eu-company-check", "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/ostrata~eu-company-check/run-sync": { "post": { "operationId": "run-sync-ostrata-eu-company-check", "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", "required": [ "companies" ], "properties": { "companies": { "title": "Companies to check", "type": "array", "description": "Company names, registration numbers, EU VAT numbers or LEIs, one per line. Optional country prefix: \"FI: Nokia\", \"NO: 923609016\". Max 5000 per run.", "items": { "type": "string" } }, "defaultCountry": { "title": "Default country for names without a prefix", "enum": [ "FR", "NO", "FI", "CZ", "ANY" ], "type": "string", "description": "Where to search company names that have no country prefix. FR, NO, FI and CZ use the official registries. ANY searches the global GLEIF LEI index (only entities that hold an LEI). Identifiers are detected automatically.", "default": "FR" }, "maxCandidatesPerQuery": { "title": "Max matches per name", "minimum": 1, "maximum": 25, "type": "integer", "description": "For name searches: how many best-matching companies to return (each returned company is one billable check). Identifier lookups always return one record.", "default": 1 }, "checkVat": { "title": "Validate VAT number in EU VIES", "type": "boolean", "description": "Live check of the company's EU VAT number in the European Commission's VIES service (VAT numbers are derived from the registry ID for FR and FI, and read from ARES for CZ).", "default": true }, "checkLei": { "title": "Cross-check LEI (GLEIF)", "type": "boolean", "description": "Look up the company's Legal Entity Identifier and its registration status in the GLEIF index.", "default": true }, "checkInsolvency": { "title": "Insolvency / liquidation flags", "type": "boolean", "description": "France: insolvency-proceeding notices (procédures collectives) published in BODACC in the last 3 years. Norway, Finland, Czechia: bankruptcy/liquidation flags from the registry.", "default": true }, "excludeSoleProprietors": { "title": "Exclude sole proprietors from name searches", "type": "boolean", "description": "Sole proprietors are registered under a person's name. When on (recommended), name searches only return legal entities. Lookups by an identifier you already have are never filtered.", "default": true }, "minNameScore": { "title": "Minimum name similarity (0–1)", "type": "string", "description": "Candidates below this similarity are dropped. A match below 0.85 is returned with verdict \"review\".", "default": "0.5" }, "includeRaw": { "title": "Include raw registry payload", "type": "boolean", "description": "Adds the untouched registry record under \"raw\" (larger output).", "default": false }, "concurrency": { "title": "Parallel queries", "minimum": 1, "maximum": 10, "type": "integer", "description": "Queries processed in parallel. Each upstream API is additionally rate-limited per host to respect its published limits.", "default": 3 } } }, "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 } } } } } } } } } }