{ "openapi": "3.0.1", "info": { "title": "Vendor Due Diligence: Company, VAT, LEI and Domain Checks", "description": "KYB check for a list of suppliers: is this vendor real? One company per row from official registries, VIES VAT validation, GLEIF LEI, domain age, mail setup and TLS certificates, plus fake vendor red flags and a published risk rule. Verify a supplier before paying an invoice.", "version": "1.0", "x-build-id": "UQo6jzMeVdtb2wCdg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/accountable_eel~vendor-due-diligence-check/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-accountable_eel-vendor-due-diligence-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/accountable_eel~vendor-due-diligence-check/runs": { "post": { "operationId": "runs-sync-accountable_eel-vendor-due-diligence-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/accountable_eel~vendor-due-diligence-check/run-sync": { "post": { "operationId": "run-sync-accountable_eel-vendor-due-diligence-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": "Which vendors do you want checked?", "type": "array", "description": "One company per line. Give whatever you already have about it: a company name plus a country, a website domain, an EU VAT number, an LEI code, or a national registry number. The precise form is name=Acme Oy|domain=acme.fi|country=FI, and a plain line like \"Acme Oy acme.fi\" is read too. Anything you leave out is simply not checked, and never counts against the company. Accepted formats: name=Supercell Oy|domain=supercell.com|country=FI, name=Doctolib|registryId=794598813|country=FR, Doctolib doctolib.fr, IE6388047V, 5493001KJTIIGC8Y1R12. You're only charged for the ones we actually find — a miss costs nothing.", "items": { "type": "string" } }, "checks": { "title": "Which checks to run", "type": "array", "description": "All six run by default. Switching one off narrows what the row says and what the red flags can see, but it does NOT change the price: a company is billed once, as a bundle, whenever at least two checks come back with real data. Leave this alone unless you specifically do not want a check made.", "items": { "type": "string", "enum": [ "registry", "vat", "lei", "domain", "dns", "tls" ], "enumTitles": [ "Official company registry (Finland, France, Norway, United States)", "EU VAT number validation (VIES)", "GLEIF LEI registry", "Domain registration date and registrar", "Mail setup: MX, SPF, DMARC", "TLS certificate history" ] }, "default": [ "registry", "vat", "lei", "domain", "dns", "tls" ] }, "testRun": { "title": "Try it first — only process the first 5", "type": "boolean", "description": "Turn this on to test your input on a small sample before running the full list. Turn it off to process everything.", "default": false }, "onlyFound": { "title": "Hide rows with no result", "type": "boolean", "description": "Only keep rows where something was actually found. Misses are always free, whether or not you show them here.", "default": false }, "includeKeywords": { "title": "Only keep rows containing", "type": "array", "description": "Optional. Only keep results that mention at least one of these words (e.g. a job title, a city, a product name). Leave empty to keep everything.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Skip rows containing", "type": "array", "description": "Optional. Drop any result that mentions one of these words. Leave empty to skip nothing.", "items": { "type": "string" } }, "maxResults": { "title": "Stop after this many results", "minimum": 1, "type": "integer", "description": "Optional. Stop the run once this many results have been found — useful for a quick, cheap sample. Leave blank for no limit." }, "columns": { "title": "Which columns do you want?", "type": "array", "description": "Choose which pieces of information to include in each result row. All are included by default.", "items": { "type": "string", "enum": [ "legalName", "registryStatus", "registryCountry", "registrySource", "registrationDate", "registeredAddress", "vatValid", "vatName", "leiStatus", "leiEntityStatus", "domainCreatedAt", "domainAgeDays", "domainRegistrar", "hasMx", "hasSpf", "hasDmarc", "tlsIssuer", "tlsValidFrom", "nameMatch", "redFlags", "riskLevel", "checksRun", "checksFound", "registryCheckStatus", "vatCheckStatus", "leiCheckStatus", "domainCheckStatus", "dnsCheckStatus", "tlsCheckStatus", "checkNotes", "sourceUrls", "inputName", "inputDomain", "inputVatNumber", "inputLei", "inputRegistryId", "inputCountry" ], "enumTitles": [ "Legal name on record", "Registry status", "Registry country", "Which registry answered", "Registered since", "Registered address", "VAT number valid?", "Name on the VAT registration", "LEI status", "LEI: is the entity active?", "Domain first registered", "Domain age in days", "Domain registrar", "Receives email?", "Has SPF", "Has DMARC", "Certificate issued by", "Newest certificate issued at", "Do the names agree?", "Red flags", "Risk level", "Checks run", "Checks that returned data", "Registry check", "VAT check", "LEI check", "Domain registration check", "Mail setup check", "Certificate check", "Why a check returned nothing", "Sources used", "Name you supplied", "Domain you supplied", "VAT number you supplied", "LEI you supplied", "Registry number you supplied", "Country used" ] }, "default": [ "legalName", "registryStatus", "registryCountry", "registrySource", "registrationDate", "registeredAddress", "vatValid", "vatName", "leiStatus", "leiEntityStatus", "domainCreatedAt", "domainAgeDays", "domainRegistrar", "hasMx", "hasSpf", "hasDmarc", "tlsIssuer", "tlsValidFrom", "nameMatch", "redFlags", "riskLevel", "checksRun", "checksFound", "registryCheckStatus", "vatCheckStatus", "leiCheckStatus", "domainCheckStatus", "dnsCheckStatus", "tlsCheckStatus", "checkNotes", "sourceUrls", "inputName", "inputDomain", "inputVatNumber", "inputLei", "inputRegistryId", "inputCountry" ] }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Parallel requests. Keep conservative — this target has no browser fallback, so getting blocked costs more than slow-and-steady.", "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 } } } } } } } } } }