{"uid":"cap_IlYH_ZZ0QGjB64VTytnpi","slug":"euroref-european-government-reference-data-history-5aa433f8","name":"euroref - European Government Reference Data History","description":"Government reference data series","url":"https://euroref.dev/v1/:country/:series/history","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object","required":["country","series"],"properties":{"series":{"enum":["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","fx-reference"],"type":"string","description":"Reference series id"},"country":{"enum":["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"],"type":"string","description":"ISO country code"}}},"queryParams":{"type":"object","properties":{},"additionalProperties":false}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1T7VENyfMWYI9jG9WZinE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves the historical time series of a specific government reference data metric (e.g. policy rate, VAT, minimum wage) for a given European country","exampleAgentPrompt":"Can you pull the full history of Germany's VAT rate from euroref — I need all the historical entries for the 'vat' series for country code 'de'?","exampleUseCases":null,"resultDescription":"Returns a structured record containing the country code, series identifier, current effective value (numeric rate or array of holiday entries), effective-from date, last-confirmed date, unit, optional breakdown of composite rate components, a staleness flag indicating whether the data is past its expected update cycle, and a source object with the data provider's name and URL.","failureModes":["Unsupported country code (not in the allowed enum: at, be, de, dk, es, fr, gb, ie, it, nl, pl, se) — likely 404 or validation error","Unsupported series ID (not in the allowed enum) — likely 404 or validation error","Data marked stale (stale: true) — endpoint returns data but it may be outdated beyond its expected refresh cycle","Payment failure — x402 payment not processed, endpoint returns 402","Service unavailable — upstream government data source temporarily unreachable"],"whenToPreferThis":"Use this endpoint when you need structured, machine-readable historical records of European government reference data such as central bank policy rates, VAT rates, minimum wages, public holidays, CPI, corporate tax, or income tax for a specific supported country. Prefer this over scraping government websites or using general web search when you need reliable, sourced, time-series data for one of the 12 supported European countries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:39:01.664Z","isFirstParty":false}