Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: euroref — European government Reference data API
version: 1.0.0
description: 'European government reference data for 35 countries as cited JSON: central-bank policy rates, VAT/GST and VAT registration thresholds, CPI, corporate, personal and withholding tax, social contributions, minimum wages, statutory interest, official FX rates, filing deadlines and public holidays (coverage varies by country). Every value carries its official source URL and last-confirmed date. Single facts $0.003; country brief (every series for one country) $0.01; cross-country compare (one series, up to 10 countries) $0.02; tax-ID and VAT-number checks $0.003; computed answers (VAT, income tax, working days, minimum-wage check) $0.01-$0.02. Pay per call in USDC on Base via x402 or MPP, no signup, or by card with credit packs or monthly plans on one key valid across all 7 regional services. Free tier: GET /catalog, plus a free email key with 50 answer calls a day, commercial use allowed. Finished answers, one cited dossier per call (supported countries vary per job; others are refused free): cost this hire (wage-floor verdict, contributions, employer cost) $0.50; charge this sale (which VAT applies, net/VAT/gross) $0.50; charge this sale certified (plus a signed VAT-rate extract) $0.75; invoice due date and statutory late interest $0.40; country evidence pack (brief plus signed extracts) $0.25; hire compare $0.75 for 2 countries, $1.00 for 3-5; next filings (VAT, PAYE, corporate-tax due dates rolled for holidays) $0.35; invoice check (VAT right or wrong, overdue interest, tax-ID format) $0.60.
Free trial: 3 successful calls per day per IP, shared across POST /v1/answers/* and POST /v1/jobs/*. No header needed (X-Free-Trial: 1 is accepted but not required); an empty-body POST gets the normal x402 402 and does not use the trial; once used up, the 402 carries free_trial_resets_at. MCP answer tools use the trial automatically when no api_key is passed. Every series of the evaluation country is free. Card credit (same per-call price as x402): /pricing.'
x-guidance: 'GET /v1/{country}/{series} returns the current value of a reference series — e.g. GET /v1/at/policy-rate. Countries: at, be, bg, ch, cy, cz, de, dk, ee, es, eu, fi, fr, gb, gr, hr, hu, ie, is, it, lt, lu, lv, mt, nl, no, pl, pt, ro, rs, se, si, sk, tr, ua. Series: policy-rate, vat, vat-registration-threshold, minimum-wage, public-holidays, cpi, corporate-tax, withholding-tax, income-tax, social-contributions, ecb-main-refinancing-rate, late-payment-interest, statutory-interest, filing-deadlines, fx-reference. Append /history for past values. GET /v1/all returns every series for every country in one call. GET /catalog (free) lists all available series with freshness metadata, each with the official source it is cited to. If you are an x402/API seller making a cross-border digital sale, POST /v1/vat/determine tells you which jurisdiction''s VAT applies, who accounts for it, and the registration trigger — cited to the statute (EU, UK, South Africa), and it handles the wallet-only unidentified-buyer case. Payment is x402 (USDC on Base) per call; no signup or API keys needed. Retention: GET /v1/changes (free; past moves and freshness), GET /v1/calendar (free; reverify_by is derived from last_confirmed + update_cycle_days; next_effective_known only when current.effective_to is set; status unknown omits any next date; notes are never parsed; not an MPC, budget, or wage-review date), and POST /alerts (register free) are how a paying agent watches a value after the first paid call. Do not re-buy a series to find out whether it moved. GET /v1/calendar is not a promised future gazette.'
contact:
name: afriref API support
email: api@3l-groupconsulting.co.za
url: https://euroref.dev/pricing
x-agentcash-owner: fou53506
termsOfService: https://euroref.dev/terms
servers:
- url: https://euroref.dev
security:
- x402Payment: []
- apiKey: []
tags:
# --- truncated at 32 KB (44 KB total) ---
# Full source: https://artifacts.apis.io/euroref-dev/openapi/euroref-dev-reference-data-api-openapi.yml