{ "openapi": "3.0.1", "info": { "title": "Slovakia VAT Checker & Tax Debt Monitor", "description": "Slovakia VAT checker and tax debt API for up to 100 companies. Verify VAT registration, cancellation or deletion risk, tax debt and reliability from official lists, or monitor deterministic changes from official Finančná správa data.", "version": "0.1", "x-build-id": "1f6ktP3jdM6JTreNl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automa-flow~slovakia-tax-vat-risk-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automa-flow-slovakia-tax-vat-risk-monitor", "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/automa-flow~slovakia-tax-vat-risk-monitor/runs": { "post": { "operationId": "runs-sync-automa-flow-slovakia-tax-vat-risk-monitor", "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/automa-flow~slovakia-tax-vat-risk-monitor/run-sync": { "post": { "operationId": "run-sync-automa-flow-slovakia-tax-vat-risk-monitor", "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": { "operation": { "title": "Operation", "enum": [ "lookup", "monitor" ], "type": "string", "description": "Lookup emits current facts; monitor compares with the last successful state for the same monitorKey.", "default": "lookup" }, "icos": { "title": "Slovak IČOs", "maxItems": 100, "type": "array", "description": "Fast start: paste one to 100 checksum-valid 8-digit company IČOs, one per line. Use Advanced companies below only for DIČ, IČ DPH, name/address lookup, or your own external IDs.", "items": { "type": "string", "minLength": 1, "maxLength": 20 } }, "companies": { "title": "Advanced companies", "maxItems": 100, "type": "array", "description": "Optional JSON entries for DIČ, IČ DPH, exact name plus city/postcode, or an externalId. You may combine these with Slovak IČOs; the total limit is 100.", "items": { "type": "object", "properties": { "ico": { "title": "IČO", "type": "string", "description": "Checksum-valid 8-digit Slovak IČO." }, "dic": { "title": "DIČ", "type": "string", "description": "10-digit Slovak DIČ." }, "vatId": { "title": "IČ DPH", "type": "string", "description": "SK plus 10 digits." }, "name": { "title": "Official company name", "type": "string", "description": "Requires city and postcode when no identifier is provided." }, "address": { "title": "Registered address", "type": "object", "description": "Official registered address used for exact identity and debtor matching.", "properties": { "street": { "title": "Street", "type": "string", "description": "Street and building number." }, "city": { "title": "City", "type": "string", "description": "Registered city or municipality." }, "postalCode": { "title": "Postcode", "type": "string", "description": "Slovak postcode; spaces are ignored for matching." }, "country": { "title": "Country", "type": "string", "description": "Country code or name; SK is assumed after RÚZ resolution." } } }, "externalId": { "title": "External ID", "type": "string", "description": "Your join key; echoed in output." } } } }, "checks": { "title": "Checks", "type": "object", "description": "VAT bank accounts are intentionally unavailable: their source licence prohibits commercial reuse.", "default": { "taxDebt": true, "vatRegistration": true, "vatCancellationRisk": true, "vatDeletion": true, "taxReliabilityIndex": true, "vatBankAccounts": false } }, "monitorKey": { "title": "Monitor key", "type": "string", "description": "Required for monitor. Isolates one watchlist's last-known-good state." }, "firstRunBehavior": { "title": "First monitor run", "enum": [ "baseline_only", "emit_current" ], "type": "string", "description": "Choose whether a new monitor emits current facts or only saves its baseline.", "default": "emit_current" }, "resetState": { "title": "Reset monitor state", "type": "boolean", "description": "Replace this monitorKey's baseline after a deliberate configuration change.", "default": false }, "requireFreshSource": { "title": "Require fresh sources", "type": "boolean", "description": "Fail stale requested sources instead of silently using them.", "default": true }, "maxSourceAgeHours": { "title": "Daily source maximum age", "minimum": 1, "maximum": 720, "type": "integer", "description": "VAT and reliability lists are expected daily.", "default": 72 }, "maxDebtSourceAgeDays": { "title": "Debt source maximum age", "minimum": 1, "maximum": 180, "type": "integer", "description": "The official debtor list follows a monthly cadence.", "default": 45 }, "minimumMatchConfidence": { "title": "Minimum debt match confidence", "minimum": 0.9, "maximum": 1, "type": "number", "description": "Name-only matches never confirm debt. 0.90–1.00.", "default": 0.9 } } }, "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 } } }, "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 } } } } } } } } } }