{ "openapi": "3.0.1", "info": { "title": "Polish Tax Interpretations & VAT Rulings API (EUREKA)", "description": "Search 560,000+ official Polish tax interpretations (KIS), binding VAT rate rulings (WIS), tax explanations and Ministry of Finance guidance from the EUREKA database. Full text as Markdown, key sections and the outcome – ready for AI agents, RAG and Claude via MCP.", "version": "1.0", "x-build-id": "kXAcbDjCQDZXWhL6L" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kris_fili~poland-tax-interpretations/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kris_fili-poland-tax-interpretations", "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/kris_fili~poland-tax-interpretations/runs": { "post": { "operationId": "runs-sync-kris_fili-poland-tax-interpretations", "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/kris_fili~poland-tax-interpretations/run-sync": { "post": { "operationId": "run-sync-kris_fili-poland-tax-interpretations", "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": { "query": { "title": "Search phrase (Polish)", "type": "string", "description": "What to look for, in Polish – e.g. 'leasing samochodu osobowego', 'ulga na złe długi', 'IP Box', 'stawka VAT catering'. Leave empty to list the newest documents. You can also paste a signature (sygnatura) or an EUREKA link here." }, "documentType": { "title": "Document type", "enum": [ "individual-interpretation", "binding-rate-information", "general-interpretation", "tax-explanations", "binding-excise-information", "local-government-interpretation", "court-rulings", "mf-guidance", "parliamentary-answers", "all" ], "type": "string", "description": "Which part of EUREKA to search. Individual interpretations are answers of the National Tax Information (KIS) to taxpayers' questions; WIS are binding decisions on the VAT rate of a product or service.", "default": "individual-interpretation" }, "detailLevel": { "title": "Detail level", "enum": [ "summary", "sections", "fullText", "all" ], "type": "string", "description": "Summary: signature, date, type, status, thesis and link – fast and cheapest. Key sections: also the facts, the question, the taxpayer's position, the authority's assessment and the outcome (position correct / incorrect). Full text: the whole document as Markdown plus the outcome. For WIS every level above Summary adds the VAT rate, classification and validity.", "default": "summary" }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "How many documents to return (EUREKA often has thousands of matches).", "default": 20 }, "sortBy": { "title": "Sort by", "enum": [ "newest", "relevance", "oldest" ], "type": "string", "description": "Newest first (recommended) shows the current approach of the tax authority. Relevance uses EUREKA's own ranking, which often puts documents from 2010–2015 first – before many law changes. Relevance needs a search phrase.", "default": "newest" }, "exactPhrase": { "title": "Match the exact phrase", "type": "boolean", "description": "On (recommended): documents containing the whole phrase. Off: documents containing any of the words – many more, less precise results.", "default": true }, "dateFrom": { "title": "Issued from (YYYY-MM-DD)", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only documents issued on or after this date, e.g. 2025-01-01." }, "dateTo": { "title": "Issued until (YYYY-MM-DD)", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only documents issued on or before this date." }, "onlyCurrent": { "title": "Only current documents", "type": "boolean", "description": "Skip documents marked as outdated, changed, expired or archived.", "default": true }, "signature": { "title": "Signature (sygnatura)", "type": "string", "description": "Exact signature or its beginning, e.g. 0114-KDIP4-2.4012.626.2026.3.MC or 0114-KDIP4. Searches all document types unless you choose one." }, "documentIds": { "title": "EUREKA document IDs or links", "type": "array", "description": "Fetch specific documents, e.g. 712074 or https://eureka.mf.gov.pl/informacje/podglad/712074 (IDs come from the 'id' field of earlier results). The search phrase is then ignored.", "items": { "type": "string" } }, "maxTextCharacters": { "title": "Maximum text length (characters)", "minimum": 0, "maximum": 2000000, "type": "integer", "description": "Shorten the full text and each section to this many characters (0 = no limit). Some interpretations exceed 100,000 characters – a limit such as 20000 keeps AI context windows small.", "default": 0 }, "includeLegalProvisions": { "title": "Legal provisions, keywords and topics", "type": "boolean", "description": "Add the cited legal provisions (e.g. '[VAT] Ustawa o podatku od towarów i usług-art. 86-ust. 1'), keywords and topics from EUREKA's index. Only with detail levels above Summary; makes the run slower.", "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 } } } } } } } } } }