# euroref - European Government Reference Data

> euroref - European Government Reference Data is a paid API for AI agents from euroref.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Returns authoritative European government reference values (policy rates, VAT rates, minimum wages, public holidays) for a given country and data series, with citations to official primary sources.

## Facts

- Endpoint: GET https://euroref.dev/v1/%7Bcountry%7D/%7Bseries%7D
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/euroref-european-government-reference-data-1af772f5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9E6qyUPtzk-iVTqfNYq0B

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability euroref-european-government-reference-data-1af772f5
```

Example prompt: What is the current ECB policy rate for Germany, and can you give me the official source citation and effective date?

## When to prefer this

Use this endpoint when you need authoritative, citation-backed European government reference values — especially for compliance, financial modeling, or legal purposes — and need an official primary source URL, effective date, and staleness indicator rather than just a raw number from an aggregator. Prefer this over generic web search when you need machine-readable structured output with provenance metadata for Germany or France.

## Known failure modes

- Invalid country code returns an error (only 'de' and 'fr' supported)
- Invalid series name returns an error (only policy-rate, vat-rate, minimum-wage, public-holidays supported)
- Stale flag set to true if official source has not been re-confirmed recently
- Truncated notes field if response is very large
- Payment required (402) if x402 micropayment header is not supplied

## How this service works

Authoritative European government reference values as clean JSON: central-bank policy rates, VAT rates, national minimum wages and public holidays for Germany (de), France (fr). Every value carries a citation to its official primary source (government gazette or central-bank statement), an effective date, a last-confirmed date and a staleness flag.

## Output

A JSON object containing: the numeric value (or structured list for public holidays), unit, series name, country code, effective date, last-confirmed date, staleness boolean, structured source citation (name + URL to official government or central bank document), disclaimer, and explanatory notes about any structural nuances (e.g. Germany has no independent monetary policy rate).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "unit": "percent",
  "notes": "STRUCTURAL NOTE: Germany has NO national policy rate. The Deutsche Bundesbank has had no independent monetary-policy competence since 1 January 1999; monetary policy for the euro area is set by the ECB Governing Council under Art. 127-133 TFEU and the ESCB/ECB Statute. The value served is the euro-area-wide ECB deposit facility rate (DFR), which applies identically in all 20 euro-area members, not a German-specific rate. On 11 June 2026 the Governing Council raised all three key rates by 25 basis points with effect from 17 June 2026: deposit facility 2.25%, main refinancing operations (MRO) 2.40%, marginal lending facility 2.65%. This was the first ECB increase since September 2023, reversing part of the eight cuts delivered between June 2024 and June 2025; the ECB cited energy-driven inflation pressure from the Middle East conflict. The DFR is served here because since the 18 March 2024 framework change the ECB steers short-term money-market rates through the DFR and narrowed the MRO-DFR spread to 15bp; the MRO rate (2.40%) remains the headline 'refinancing' rate cited by some sources. No Governing Council monetary-policy meeting fell between 17 June 2026 and the last_confirmed date, so 2.25% is still in force. Note separately that the German statutory Basiszinssatz under Section 247 BGB, published semi-annually by the Bundesbank and used for default interest, is a distinct national figure and is NOT a monetary policy rate. Access: ecb.europa.eu serves the full key-rates table as static HTML and loaded cleanly.",
  "stale": false,
  "value": 2.25,
  "series": "policy-rate",
  "source": {
   "url": "https://www.ecb.europa.eu/press/pr/date/2026/html/ecb.mp260611~4d41bd5e83.en.html",
   "name": "European Central Bank, Monetary policy decisions of the Governing Council, 11 June 2026 (press release ecb.mp260611); Key ECB interest rates statistical table"
  },
  "country": "DE",
  "disclaimer": "Independent service, not affiliated with any government. Verify against the cited official source before legal or financial use.",
  "effective_from": "2026-06-17",
  "last_confirmed": "2026-07-20"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/euroref-european-government-reference-data-1af772f5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from euroref.dev](https://www.zero.xyz/host/euroref.dev/llms.txt)