{"uid":"cap_H4_fgozhx2JLUfTK_-Drk","slug":"usaref-government-reference-data-history-f05f690d","name":"usaref Government Reference Data History","description":"Government reference data series","url":"https://usaref.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","statutory-interest","income-tax","social-contributions","fx-reference","sales-tax"],"type":"string","description":"Reference series id"},"country":{"enum":["bs","ca","cr","do","gt","hn","mx","pa","sv","us"],"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_TiUm-9c5gQDU8ficFnw_6","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":"Returns the historical time-series of a specific government reference data series (e.g. policy rate, VAT, minimum wage) for a given North American country","exampleAgentPrompt":"Can you pull the full policy-rate history for Mexico from usaref so I can see how their central bank rate has changed over time?","exampleUseCases":null,"resultDescription":"A JSON object containing the country code, series identifier, current value, unit, effective_from date, last_confirmed date, source attribution (name and URL), a staleness flag, optional notes, and optional rate component breakdowns where applicable (e.g. stacked statutory levies).","failureModes":["Invalid country code returns 400 or 404 — only ca, cr, do, gt, hn, mx, pa, sv, us are supported","Invalid series ID returns 400 or 404 — only policy-rate, vat, minimum-wage, public-holidays, cpi, corporate-tax, income-tax are valid","stale:true in response indicates data is past its expected update cycle and may be outdated","Payment failure (x402) if USDC payment is not correctly included","Network timeout or 5xx if the upstream data source is unavailable"],"whenToPreferThis":"Use this endpoint when you need historical time-series data for a specific government reference metric (tax rates, wages, interest rates, CPI, holidays) for a North American or Central American country. Prefer this over the snapshot endpoint when you need the full history rather than just the current value. Best suited for compliance checks, economic analysis, or policy tracking tasks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:35:56.776Z","isFirstParty":false}