Pricing
euroref sells European government reference data — every value cited to the official government or central-bank source it came from. Buy prepaid credit with a card, or pay per call. Same data, same API.
Free API key, no card, commercial use allowed: 50 answer calls a day (reset 00:00 UTC) and unlimited public holidays for every country, on every brand. Get a free key with your email.
Prepaid credit — pay by card
A one-time purchase. You receive an API key with prepaid credit, usable immediately. Each call costs the same US-dollar price as over x402. Packs are not a subscription and never recur — when the credit runs out, buy another pack if you want more. Prefer a monthly allowance? See the monthly plans below.
About a month of typical agent usage. Start here.
$0.0010 per credit: up to 3,333 series calls, 5,000 holiday lookups, or 100 certified extracts
Buy on afriref.dev — $10For a service calling us on a schedule.
$0.0010 per credit: up to 8,333 series calls, 12,500 holiday lookups, or 250 certified extracts
Buy on afriref.dev — $25Production workloads and bulk backfills.
$0.0010 per credit: up to 33,333 series calls, 50,000 holiday lookups, or 1,000 certified extracts
Buy on afriref.dev — $100Card checkout runs on our afriref.dev domain — one checkout serves the whole fleet, and the key you receive works here on euroref exactly as it works there: same key, same balance, all seven regional services.
Monthly plans — pay by card
A monthly subscription that refills one API key with a fresh credit allowance each billing month. Same credits and per-call prices as the packs ($0.001 per credit, each call debits its listed price), at a lower price per credit because the allowance is monthly. Unused credit does not roll over. Cancel any time from the link in your Paddle receipt; the key keeps working until the end of the month you paid for.
One product or agent calling us every day.
$0.00063 per credit (37% below the packs): up to 10,000 series calls, 3,000 country briefs or 1,500 computed answers a month
Subscribe on afriref.dev — $19/monthPayroll, invoicing or HR tools in production.
$0.00054 per credit (46% below the packs): up to 30,000 series calls, 9,000 country briefs or 4,500 computed answers a month
Subscribe on afriref.dev — $49/monthFintech and multi-country workloads.
$0.00050 per credit (50% below the packs): up to 100,000 series calls, 30,000 country briefs or 15,000 computed answers a month
Subscribe on afriref.dev — $149/monthHow the two payment rails charge: both rails charge the same US-dollar price per call. By card, prepaid credit is worth $0.001 per credit on the $10, $25 and $100 packs and each successful call debits its endpoint price in credits (a $0.003 value is 3 credits, a $0.002 holidays call is 2, an alert delivery after the free trial is 50, a $0.10 certified extract is 100); over x402, every call pays the price quoted in its own 402 challenge, $0.002 to $1.00 depending on the endpoint (listed on the pricing page). Failed or refused calls are not charged on either rail. Keys bought up to 16 October 2026 keep their original terms1.
Credit does not expire. Prices are in US dollars and exclude any sales tax or VAT, which is calculated at checkout based on your location. For an invoice, volume pricing or a purchase order, write to [email protected].
Data licence — contact us
Need the dataset itself, not per-call access? We license the full cited dataset (every series, every country, with sources, history and change feed) for internal use, redistribution inside your product, or bulk loading into your own systems, on an annual licence. Write to [email protected] with the countries, series and use you have in mind.
Volume & enterprise — invoiced
Higher volumes are billed by invoice or purchase order rather than card, and priced below the standard rate. Published rates, not "contact us for a quote":
| Tier | Price | Credit value | Discount |
|---|---|---|---|
| Volume | $400 | $500 (500,000 credits) | 20% off |
| Volume plus | $1,500 | $2,500 (2,500,000 credits) | 40% off |
| Enterprise | from $2,500 | $5,000+ (5,000,000+ credits) | 50% off |
Credits are $0.001 of list price each and debit the per-call prices below. Invoiced annually or on purchase order, payable by card or bank transfer. Enterprise includes a named support contact and advance notice of breaking API changes. Larger volumes are quoted on request and will not exceed half the listed per-call price. Write to [email protected].
Finished jobs — one call, one cited dossier
A finished job answers a whole question in one paid call, with every figure cited to its official source. Anything we cannot answer in full is refused free before payment, so you are only charged for a complete answer. The 3 free calls per IP per day are shared with the answer endpoints. By card, a job debits its price in credits (250 to 1000 credits). The same jobs and prices apply on all seven brands: fleet catalog.
| Job | Price (USD) | Credits |
|---|---|---|
POST /v1/jobs/cost-hire — cost this hire: wage-floor verdict, contributions or PAYE net pay, employer costCountries here: DE, ES, GB, IT, PL | $0.50 | 500 credits |
POST /v1/jobs/charge-sale — charge this sale: whether and which VAT to put on an invoice, net / VAT / grossCountries here: cross-border under the EU, UK and South Africa rules on every brand; single-country rate maths for this brand's countries | $0.50 | 500 credits |
POST /v1/jobs/charge-sale/certified — charge this sale plus a signed certified extract of the governing VAT rateCountries here: as charge this sale, where the source is currently fingerprinted | $0.75 | 750 credits |
POST /v1/jobs/invoice-payable — invoice due date and late interest: days overdue and statutory interest owedCountries here: AT, BE, BG, CY, DE, DK, EE, ES, FI, FR, GB, GR, HR, IE, IT, LT, LU, LV, MT, NL, PL, PT, SE, SI, SK, CH, CZ, HU, IS, NO, RO, RS, TR | $0.40 | 400 credits |
POST /v1/jobs/evidence-pack — country evidence pack: cited country brief plus up to 3 signed certified extractsCountries here: every country here with a certifiable series | $0.25 | 250 credits |
POST /v1/jobs/hire-compare — hire compare, 2 countries: employer cost and contributions side by side, rankedCountries here: AE, AU, CA, DE, ES, GB, IT, MX, PL, US (on every brand) | $0.75 | 750 credits |
POST /v1/jobs/hire-compare/multi — hire compare, 3 to 5 countriesCountries here: AE, AU, CA, DE, ES, GB, IT, MX, PL, US (on every brand) | $1.00 | 1,000 credits |
POST /v1/jobs/next-filings — next filings: VAT, PAYE and corporate-tax due dates rolled for weekends and holidaysCountries here: CH, CZ, DE, DK, ES, FI, FR, GB, IE, IT, LU, NL, NO, PL, PT, RO, SE, TR | $0.35 | 350 credits |
Machine-readable: /fleet/catalog.json and /openapi.json (tag Jobs).
Per-call pricing for automated clients
Machine clients that prefer to settle each request individually, rather than hold a balance, can do so without an account or an API key. Per-call rates are listed below; see the developer documentation for how to authorise a request.
These are the rates the x402 payment challenge actually quotes, settled in USDC on Base. How the two payment rails charge: both rails charge the same US-dollar price per call. By card, prepaid credit is worth $0.001 per credit on the $10, $25 and $100 packs and each successful call debits its endpoint price in credits (a $0.003 value is 3 credits, a $0.002 holidays call is 2, an alert delivery after the free trial is 50, a $0.10 certified extract is 100); over x402, every call pays the price quoted in its own 402 challenge, $0.002 to $1.00 depending on the endpoint (listed on the pricing page). Failed or refused calls are not charged on either rail. Keys bought up to 16 October 2026 keep their original terms1.
| Endpoint | Price (USD) | Credits |
|---|---|---|
GET /v1/{country}/{series} — current value | $0.003 | 3 credits |
GET /v1/{country}/{series}/history | $0.003 | 3 credits |
GET /v1/holidays/{country} — public holidays, cited (paid copy for x402 clients; the same data stays free at /v1/{country}/public-holidays) | $0.002 | 2 credits |
GET /v1/brief/{country} — country brief: every series for one country in one call | $0.01 | 10 credits |
GET /v1/compare?series=&countries= — one series across up to 10 countries | $0.02 | 20 credits |
GET /v1/taxid/validate?country=&id= — tax-ID / VAT-number format and check-digit validation (offline; coverage free) | $0.003 | 3 credits |
GET /v1/all — full snapshot | $0.02 | 20 credits |
POST /v1/answers/working-days — business days, holidays, next working day | $0.002 | 2 credits |
POST /v1/answers/vat — net / tax / gross | $0.01 | 10 credits |
POST /v1/answers/income-tax — tax due plus per-bracket workings | $0.02 | 20 credits |
POST /v1/answers/wage-check — is this salary legal? | $0.02 | 20 credits |
POST /v1/answers/settlement-date — T+n settlement/value date across national calendars | $0.02 | 20 credits |
POST /v1/vat/determine — cross-border VAT treatment of a digital sale | $0.05 | 50 credits |
POST /v1/answers/statutory-interest — simple interest on a principal at the cited statutory-interest rate (Actual/365) | $0.02 | 20 credits |
POST /v1/answers/employment-cost — cost to employ (statutory contributions, both sides; DE, ES, GB, IT, PL only) | $0.05 | 50 credits |
POST /alerts — signed change webhooks | Register: $0 Delivery after trial: $0.05 | Register: 0 credits Delivery after trial: 50 credits |
GET /v1/certified/{country}/{series} — signed certified extract | $0.10 | 100 credits |
/catalog and /v1/{country}/public-holidays | Free | Free |
/v1/changes — what changed, and how recently every series was re-verified against its official source | Free | Free |
/v1/calendar — re-verification window derived from last_confirmed + update_cycle_days; a recorded effective_to end only when that field is already set. Not a future gazette. Notes are not parsed | Free | Free |
/settlement-conventions — every settlement cycle we cite, and the ones we refuse to | Free | Free |
1 Legacy keys: Keys bought before 12 October 2026 keep their original one-credit-per-call terms, and keys bought from 12 to 16 October keep $0.005 credits.
Change feed — free. GET /v1/changes. What moved, and how recently we re-verified every series. Poll this after you have paid once.
Re-verification calendar — free. GET /v1/calendar. reverify_by is derived from last_confirmed + update_cycle_days (the same window that sets stale). next_effective_known appears only when the current value already has effective_to; it is that recorded end, not an MPC, budget, or wage-review date. status: unknown omits the date and is still free. We do not parse notes. Past moves stay on GET /v1/changes; push stays on POST /alerts.
Webhook alerts — register free. POST /alerts. HMAC-signed. First 3 deliveries free; after that one prepaid-key call per delivery ($0.05 ladder). Same endpoint watches official documents by sha256. Unknown URLs refused free.
Answer receipts — included when requested. On a paid answer POST (wage-check, VAT, working-days, settlement-date, income-tax, statutory-interest, employment-cost), set receipt: true. Statutory interest is included: the signed answer_receipt rides on that $0.02 answer with no extra charge. The paid HTTP 200 then includes an Ed25519-signed answer_receipt, verified at /certified/public-key. No extra charge beyond that answer's listed price. This is not the series certified extract (GET /v1/certified/{country}/{series} at $0.10).
What you are buying
Statutory reference data for the countries euroref covers — central-bank policy rates, VAT and sales-tax rates, statutory minimum wages, income-tax brackets and public holidays — plus computed answers built on it: business-day and settlement-date calculations, VAT breakdowns, income-tax workings, simple statutory interest at the cited series rate (Actual/365), employment-cost calculations (DE, ES, GB, IT and PL only).
Delivery is instant and entirely digital. Data is monitored against its official source and flagged stale: true when it passes its expected update cycle. See our refund policy before purchasing.
Not what you were looking for?
If the packs above do not fit — you need a different set of countries, a bulk extract, a licence for redistribution, an SLA, or something we do not sell yet — say so here. It goes straight to the person who maintains the data.