# 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.02/call, status unknown (last checked 2026-09-13).

Returns authoritative European government reference values (ECB policy rates, VAT rates, minimum wages, public holidays) for Germany and France as cited JSON with staleness flags.

## Facts

- Endpoint: GET https://euroref.dev/v1/all
- Price: $0.02/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-981478cc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0NWuWr6y3FxI-RXRri4I-

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-981478cc
```

Example prompt: Can you get me the current ECB policy rate, VAT rate, minimum wage, and public holidays for Germany and France, with official source citations and staleness flags, from euroref?

## When to prefer this

Choose euroref when you need authoritative, cited European government reference values (ECB rates, VAT, minimum wages, public holidays) for Germany or France in clean JSON with provenance metadata. Prefer it over scraping government sites directly when you need staleness flags and primary-source citations pre-packaged. Best for compliance, fintech, payroll, and regulatory applications where auditability of the source matters.

## Known failure modes

- Network or upstream unavailability returns an error response
- Data may be flagged stale if official sources have not been re-confirmed recently (stale:true)
- Input schema is minimal and does not support filtering by country or series type at the /v1/all endpoint — all data is returned
- Truncated or missing data if upstream government/ECB sources change their structure
- Payment required (HTTP 402) if x402 payment header is not provided

## 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 array of reference data series for Germany (DE) and France (FR), each entry containing: the numeric value and unit, the data series type (policy-rate, VAT, minimum-wage, public-holidays), country code, effective date, last-confirmed date, a boolean staleness flag, and a source object with the official primary source name and URL (government gazette or central-bank statement). Notes and disclaimers are included where structurally relevant.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": [
  {
   "series": [
    {
     "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"
    }
   ],
   "country": "DE"
  }
 ]
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/euroref-european-government-reference-data-981478cc/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)
