EU VAT Rates Fetcher

Pricing

Rating

Developer

Actor stats

Categories

Share

This actor fetches EU VAT rates from ECB, validates and normalizes the payload, and writes output to dataset and key-value store.

Input

• requestTimeoutMs (integer): request timeout in milliseconds.
• countries (string[]): optional country code allow-list (for example AT, DE).
• pushIndividualItems (boolean): when true, pushes one dataset item per country instead of one summary object.
• serveApi (boolean): run as HTTP API server for URL-based GET requests.

API Endpoint Mode

When serveApi=true, the actor runs an HTTP server and exposes:

Port behavior:

• Uses Apify default web server port from ACTOR_WEB_SERVER_PORT.

• Falls back to 3000 for local runs when that variable is not set.

• GET /vat_rates

• Query params:

  • countries=AT,DE,FR (optional)
  • requestTimeoutMs=30000 (optional)

Example request:

$curl"http://127.0.0.1:3000/vat_rates?countries=AT,DE"

Readiness endpoint:

• GET / returns health metadata (and readiness probe OK for Apify standby checks).

Use Cases

• Keep a current VAT rate table for EU countries in your internal pricing system.
• Build tax-aware product pricing for marketplaces by filtering only target countries (for example AT, DE, FR).
• Feed finance or BI workflows with normalized VAT data from a single structured source.
• Store daily snapshots in Apify dataset / key-value store for auditing VAT changes over time.

Output

• Dataset:
  • One summary object by default.
  • One object per country when pushIndividualItems=true.
• Key-value store:
  • OUTPUT key with summary object:
    • success
    • fetchedAt
    • countryCount
    • rates

Example Response JSON

{
"success":true,
"fetchedAt":"2026-04-17T12:34:56.000Z",
"countryCount":2,
"rates":{
"AT":{
"country_name":"Austria",
"standard_rate":20,
"reduced_rates":[10,13],
"super_reduced_rates":[],
"parking_rates":[13]
},
"DE":{
"country_name":"Germany",
"standard_rate":19,
"reduced_rates":[7],
"super_reduced_rates":[],
"parking_rates":[]
}
}
}