{ "openapi": "3.0.1", "info": { "title": "EU Dealer Counterparty Check — KYB & AML Verification", "description": "Verify a European company before you sign a deal. Give a name and/or registration number plus a country, and it queries the matching official company registry across 11 EU countries and merges the result into one dossier: legal name, status, address, incorporation date, officers, red flags.", "version": "0.1", "x-build-id": "x8BNVaredCePe7JZM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~eu-dealer-counterparty-check/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-eu-dealer-counterparty-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/studio-amba~eu-dealer-counterparty-check/runs": { "post": { "operationId": "runs-sync-studio-amba-eu-dealer-counterparty-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/studio-amba~eu-dealer-counterparty-check/run-sync": { "post": { "operationId": "run-sync-studio-amba-eu-dealer-counterparty-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": [ "country" ], "properties": { "companyName": { "title": "Company name", "type": "string", "description": "Name of the company to check. Required if no registration number is given. Example: 'Siemens AG', 'Boulangerie Guillaume'." }, "registrationNumber": { "title": "Registration number (optional)", "type": "string", "description": "Official registry number if you have it: SIREN/SIRET (FR), Companies House number (UK), KRS or NIP (PL), HRB/HRA register number (DE), Codice Fiscale / Partita IVA (IT), CIF/NIF (ES), UID (CH), organisasjonsnummer (NO), org.nr (SE), KVK number (NL), IČO (CZ). A number narrows the lookup to an exact match instead of a name search." }, "country": { "title": "Country", "enum": [ "auto", "DE", "FR", "GB", "PL", "IT", "ES", "CH", "NO", "SE", "CZ", "NL" ], "type": "string", "description": "Country whose registry to check. Pick 'Auto-detect' to let the actor guess from the registration number format (only works for formats with a distinctive pattern: CH UID, DE HRB/HRA number, PL KRS number). If auto-detect can't determine the country, the run fails with a clear message asking you to set this field.", "default": "DE" }, "enrichRedFlags": { "title": "Enrich with red-flag sources", "type": "boolean", "description": "Run an extra secondary source where available to surface insolvency/filing red flags: Bundesanzeiger for Germany (insolvency & capital-market filings), Proff.no for Norway (financials/board cross-check), Recherche Entreprises for France (official gov cross-check). Adds one extra child-actor call and a few seconds. On by default.", "default": true }, "maxResults": { "title": "Max candidate matches to scan", "type": "integer", "description": "How many matches the underlying registry search fetches before the best match is picked. Higher values help disambiguate a common company name but cost more child-actor compute. The dossier itself is always a single merged result.", "default": 10 }, "timeoutPerSourceSecs": { "title": "Per-source timeout (seconds)", "type": "integer", "description": "How long to wait for each registry child-actor before giving up on it for this dossier. Sources run in parallel, so a run takes about as long as its slowest source, not the sum. A source that is still running when this elapses is reported as timed out (not failed) and its run is aborted so it stops costing you compute. Raise it if you see timeouts on detail-heavy registers.", "default": 240 }, "proxyConfiguration": { "title": "Proxy configuration (advanced — leave empty)", "type": "object", "description": "Only set this to FORCE a specific proxy on every underlying registry child-actor. Leave empty (default) so each child-actor uses its own country-tuned proxy default instead — several registries need a specific country's RESIDENTIAL proxy, and a generic override here replaces that with a slower or less reliable choice.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }