{"uid":"cap_Ht1vPci6TphKoTvlfhy9M","slug":"usaref-country-brief-north-america-5e57c619","name":"Usaref Country Brief - North America","description":"North American country brief: every government reference series for one country in one call (policy rate, VAT/GST, CPI, income/corporate/withholding tax, minimum wage, holidays...), each with value, unit, effective date, last-confirmed date, official source and confidence label","url":"https://usaref.dev/v1/brief/:country?utm_source=zero.xyz","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"},"queryParams":{"type":"object","properties":{},"additionalProperties":false}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Rr3ocQ1kRVxQHgFXDg0jr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns every government reference data series for a single North American country in one call, including policy rates, VAT/GST, CPI, tax rates, minimum wage, and public holidays with official sources and confidence labels.","exampleAgentPrompt":"Pull the full government reference brief for Canada — I need the policy rate, VAT/GST, corporate tax rate, income tax rate, minimum wage, and CPI all in one go, each with the official source and effective date.","exampleUseCases":[{"title":"Tax compliance check for cross-border payroll","prompt":"I'm setting up payroll for employees in Mexico — can you get me all the official government figures I need: income tax rate, corporate tax, withholding tax, VAT, and minimum wage, each with the official gazette source and when it was last confirmed?"},{"title":"Macroeconomic snapshot for investment memo","prompt":"I'm writing an investment brief on Canada and need a full government data snapshot — central bank policy rate, CPI, corporate and income tax rates, all cited to official sources with effective dates."},{"title":"Regulatory data enrichment for fintech onboarding","prompt":"Our app is onboarding users in the United States and I need the current official values for VAT/GST, income tax rates, corporate tax rate, and minimum wage with confidence labels so we can pre-populate our compliance forms."}],"resultDescription":"A structured JSON object containing every covered government reference series for the requested North American country. Each series entry includes the current value, unit, effective date, last-confirmed date, a URL to the official government source, and a confidence label indicating data freshness and reliability. Series covered include central bank policy rate, VAT/GST, CPI, income tax, corporate tax, withholding tax, minimum wage, and public holidays.","failureModes":["Unsupported country code (not a covered North American country) returns an error or empty result","Stale data flag if the official source has not been re-confirmed recently","Invalid ISO 3166-1 alpha-2 format returns a 400 bad request","Payment failure via x402 protocol if USDC balance is insufficient"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive, multi-series government reference snapshot for a single North American country in one API call rather than making separate calls for each data series. It is ideal when you need official-source citations and confidence labels alongside values, and when you want to avoid stitching together data from multiple endpoints. Prefer it over individual series endpoints when breadth of coverage matters more than depth on a single metric.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T12:33:40.733Z","isFirstParty":false,"canonicalSlug":"usaref-country-brief-north-america-5e57c619"}