{ "openapi": "3.0.1", "info": { "title": "Poland VAT Whitelist - NIP & Bank Account Checker", "description": "Check Polish VAT status and registered bank accounts by NIP, for one supplier or up to 3,000, in the official White List (Biała Lista). Keep the Ministry request ID and an explicit status on every row. Optionally monitor later VAT or account changes. A failed check is never reported as absence.", "version": "0.1", "x-build-id": "yoMoYEDxr6UiEycIr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automa-flow~poland-vat-whitelist-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automa-flow-poland-vat-whitelist-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~poland-vat-whitelist-monitor/runs": { "post": { "operationId": "runs-sync-automa-flow-poland-vat-whitelist-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~poland-vat-whitelist-monitor/run-sync": { "post": { "operationId": "run-sync-automa-flow-poland-vat-whitelist-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", "required": [ "records" ], "properties": { "records": { "title": "NIPs and bank accounts", "minItems": 1, "maxItems": 3000, "type": "array", "description": "One row per supplier. NIP accepts PL, spaces and dashes and is checksum-validated before any request. reference is echoed unchanged. bankAccount accepts a checksum-valid Polish NRB or PL IBAN and is never written to logs.", "items": { "type": "object", "required": [ "nip" ], "properties": { "nip": { "title": "Supplier NIP", "type": "string", "description": "Polish NIP. PL prefix, spaces and dashes are normalized; the 10-digit checksum must be valid.", "editor": "textfield", "maxLength": 64 }, "reference": { "title": "Your reference", "type": "string", "description": "Optional AP, ERP, supplier or invoice join key echoed unchanged in this input row's result.", "editor": "textfield", "maxLength": 128 }, "bankAccount": { "title": "Account to verify", "type": "string", "description": "Optional checksum-valid Polish NRB or PL IBAN. The authoritative check returns TAK/NIE; output shows only its last four digits.", "editor": "textfield", "maxLength": 128 } }, "additionalProperties": false } }, "asOfDate": { "title": "Register date", "type": "string", "description": "Optional YYYY-MM-DD date supported by the official register. Defaults to today's Europe/Warsaw date." }, "mode": { "title": "Mode", "enum": [ "snapshot", "monitor" ], "type": "string", "description": "snapshot returns the current official observation. monitor compares with the last verified state for monitorId + NIP; its first successful run is a baseline.", "default": "snapshot" }, "monitorId": { "title": "Monitor ID", "minLength": 1, "maxLength": 64, "type": "string", "description": "Required in monitor mode. A stable 1-64 character watchlist key using letters, digits, dots, underscores or hyphens." }, "onlyChanges": { "title": "Minimize unchanged rows", "type": "boolean", "description": "In monitor mode, unchanged suppliers still emit one explicit reconciliation row, but repeat profile details are omitted. Changed, baseline and failed rows remain complete.", "default": false }, "includeFullBankAccounts": { "title": "Include full registered accounts", "type": "boolean", "description": "Off by default. Enable only when your workflow requires full registered account numbers. Monitor state still retains hashes only and logs never contain full accounts.", "default": false } } }, "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 } } } } } } } } } }