{"uid":"cap_RBBx5PkFfZmT41la6Dnfn","slug":"usaref-government-reference-data-series-e88400d0","name":"usaref Government Reference Data Series","description":"Government reference data series","url":"https://usaref.dev/v1/:country/:series","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_aCnu7UOs8nYj__d0CZ4fg","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 a single government reference data series (e.g. policy rate, VAT, minimum wage, CPI, corporate tax, income tax, or public holidays) for a specified North American country","exampleAgentPrompt":"What is the current VAT rate in Mexico? Pull it from usaref and let me know the effective date and whether the data might be stale.","exampleUseCases":[{"title":"Canada policy rate for financial modeling","prompt":"I'm building a cash flow model and need the current Bank of Canada policy interest rate. Can you pull that from usaref and tell me the effective date and the source so I can cite it properly?"},{"title":"US minimum wage compliance check","prompt":"We're onboarding a new contractor in the US and I want to make sure our pay rate is compliant. What's the current federal minimum wage? Grab it from usaref and let me know if the data is still fresh."},{"title":"Costa Rica public holidays this year","prompt":"I'm scheduling a project kickoff with our Costa Rica team and need to avoid local public holidays. Can you look up this year's public holidays in Costa Rica from usaref and list the dates and names?"}],"resultDescription":"A JSON object containing the country code, series identifier, current value (a number for rates/wages or an array of date+name objects for holidays), effective-from date, last-confirmed date, unit, source name and URL, a stale boolean flag, and optionally a breakdown of rate components and a combined effective rate where statutory levies stack.","failureModes":["Unsupported country code returns a 4xx error — only ca, cr, do, gt, hn, mx, pa, sv, us are supported","Unsupported series ID returns a 4xx error — only policy-rate, vat, minimum-wage, public-holidays, cpi, corporate-tax, income-tax are valid","stale:true in response indicates the data is past its expected update cycle and may not reflect the latest official figure","Payment failure (x402) if USDC balance is insufficient or payment not properly handled","Network timeout if the upstream government data source is temporarily unavailable"],"whenToPreferThis":"Use this endpoint when you need authoritative, structured government reference data for North American countries (US, Canada, Mexico, Central America) and need a single well-defined series such as VAT, minimum wage, CPI, or tax rates. Prefer this over general web search when you need machine-readable values with source attribution and freshness metadata. Ideal for compliance checks, financial modeling, or enriching business data with current regulatory parameters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:35:58.707Z","isFirstParty":false}