Pricing

from $1.00 / 1,000 results

Try for free

Go to Apify Store

Polish Tax Interpretations & VAT Rulings API (EUREKA)

Try for free

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.

Pricing

from $1.00 / 1,000 results

Rating

0.0

(0)

Developer

Krzysztof Filipiak

Actor stats

Bookmarked

Total users

Monthly active users

5 days ago

Last modified

Categories

Business

Automation

You can access the Polish Tax Interpretations & VAT Rulings API (EUREKA) programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Polish Tax Interpretations API – EUREKA, KIS, WIS VAT OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Polish Tax Interpretations & VAT Rulings API (EUREKA) from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Polish Tax Interpretations & VAT Rulings API (EUREKA) API in Python

Polish Tax Interpretations & VAT Rulings API (EUREKA) API in JavaScript

Polish Tax Interpretations & VAT Rulings API (EUREKA) API through CLI

Polish Tax Interpretations & VAT Rulings API (EUREKA) API

County Tax Sale Auction Monitor - Nationwide Calendar

genetheaiguy/county-tax-sale-monitor

Nationwide county tax sale & foreclosure auction calendar as structured data — county, state, sale type, dates, auction links — with new-auction detection between runs. For real estate investors. MCP-ready.

Gene Swank

Property Tax: 50-State Rates, Exemptions, Appeal Rates

andrew_avina/property-tax-intelligence-mcp

Investor property tax rates for all 50 states + counties. Homestead exemptions (investors excluded), appeal deadlines, appeal success rates. TX: 65-70% appeal success (highest US). HI: 0.27% (lowest). NJ: 2.23% (highest). MCP-native.

Andrew Avina

Brazil IBGE Municipalities & State Geodata Directory API

prepared_crispbread/brazil-ibge-municipalities-geodata

Retrieves official IBGE 7-digit municipality codes and city directories by Brazilian state (UF) via BrasilAPI for tax issuance (NFS-e/NF-e), logistics routing, and regional B2B intelligence.

Radar Quant AI

US Weather Forecast Scraper: official NWS forecasts and alerts

bepolabs/us-weather

Temperature, rain chance, wind and humidity per hour from weather.gov, no key needed, metric or imperial units.

BEPO Labs

Llm Ready Documentation Scraper

direct_duty/llm-ready-documentation-scraper

Developers and AI agents need to read documentation (e.g. Stripe Docs, Next.js Docs), but standard scrapers return noisy HTML that includes: navigation bars headers / footers ads / cookie banners This Actor must return pure content-only Markdown, suitable for vectorization and semantic search.

Sean

Brazil FIPE Vehicle Pricing API (Cars, Trucks & Motos)

prepared_crispbread/brazil-fipe-vehicle-pricing-api

Queries official Brazilian FIPE Table (Tabela FIPE via BrasilAPI) for average market prices and vehicle catalog of cars, motorcycles, and trucks for insurance, auto dealers, and lending fintechs.

Radar Quant AI

France Property Valuation & Sold Prices (DVF)

kris_fili/france-property-valuation-dvf

Value any apartment or house in France from official DVF sale prices (notarial deeds): estimate, price per m², range, comparable sales, or a market report for any address or commune.

Krzysztof Filipiak

Otodom & OLX Listing Deal Checker – Notarial Deed Prices

kris_fili/otodom-listing-deal-checker

Check Polish apartment listings (Otodom, OLX, Morizon, Gratka scrapers) against real sale prices from notarial deeds: fair value, % above or below, deal verdict.

Krzysztof Filipiak

Article Extractor: News & Blog Text, Author, Date to JSON

precious_bathmat/article-extractor

Extract clean article text and Markdown, title, authors, publish date, publisher, section, tags and image from any news or blog article. Give it a news site or section and it finds the newest articles through the RSS feed. No browser, no API key.

Mariam Ahmed

LatAm Tax ID Validator & CFDI Parser

autoaugeo/latam-tax-id-validator-2766

Checks format and check digits of Latin American tax IDs (CUIT, RUT, RFC, CURP, CPF, CNPJ, NIT, RUC) and parses CFDI invoice XML into JSON. Format and check digits only: it does not confirm an ID is registered or active. Independent of any tax authority. AI-assisted.