{"uid":"cap_1scgaUyrWr5tQq7XkWy54","slug":"usaref-changes-feed-north-american-government-reference-data-b844e70d","name":"usaref Changes Feed – North American Government Reference Data","description":"North American government reference data for 10 countries as cited JSON: central-bank policy rates, VAT/GST and VAT registration thresholds, CPI, corporate, personal and withholding tax, social contributions, minimum wages, statutory interest, official FX rates, filing deadlines and public holidays (coverage varies by country). Every value carries its official source URL and last-confirmed date. Single facts $0.003; country brief (every series for one country) $0.01; cross-country compare (one series, up to 10 countries) $0.02; tax-ID and VAT-number checks $0.003; computed answers (VAT, income tax, working days, minimum-wage check) $0.01-$0.02. Pay per call in USDC on Base via x402 or MPP, no signup, or by card with credit packs or monthly plans on one key valid across all 7 regional services. Free tier: GET /catalog, plus a free email key with 50 answer calls a day, commercial use allowed. Finished answers, one cited dossier per call (supported countries vary per job; others are refused free): cost this hire (wage-floor verdict, contributions, employer cost) $0.50; charge this sale (which VAT applies, net/VAT/gross) $0.50; charge this sale certified (plus a signed VAT-rate extract) $0.75; invoice due date and statutory late interest $0.40; country evidence pack (brief plus signed extracts) $0.25; hire compare $0.75 for 2 countries, $1.00 for 3-5; next filings (VAT, PAYE, corporate-tax due dates rolled for holidays) $0.35.\n\nFree trial: 3 computed-answer calls per day per IP on POST /v1/answers/* with header X-Free-Trial: 1 (without it, the normal x402 402; once used up, the 402 carries free_trial_resets_at). MCP answer tools use the trial automatically when no api_key is passed. Every series of the evaluation country is free. Card credit (same per-call price as x402): /pricing.","url":"https://usaref.dev/v1/changes?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":null,"responseSchema":{"type":"json","example":{"since":"2026-07-01","changes":[{"series":"minimum-wage","country":"AR","effective_from":"2026-07-01"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_mCOrvk5gbkhqj6ODfNGwA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a list of government reference data series (policy rates, VAT, minimum wages, public holidays) that have changed since a given date for Canada and/or the US.","exampleAgentPrompt":"What North American government reference data series have changed since July 1, 2026? I care about Canada and the US — things like minimum wages, central bank rates, VAT, and public holidays.","exampleUseCases":[{"title":"Compliance monitoring for payroll system","prompt":"Has the minimum wage changed in Canada or the US since January 1, 2026? I need to know which series were updated so I can flag them for our payroll compliance team."},{"title":"Macro research data freshness check","prompt":"Pull all the government reference data changes for the US since April 1, 2026 — I want to see if central bank policy rates or any other official figures have been updated so I can refresh my economic models."},{"title":"Automated regulatory change alert","prompt":"Check whether any North American government data series — wages, VAT, public holidays, or policy rates — have changed since June 1, 2026, and list everything that's been updated with its effective date."}],"resultDescription":"A JSON object with a 'since' date and a 'changes' array. Each change entry includes the series name (e.g. 'minimum-wage'), the country code (e.g. 'us' or 'ca'), and the effective date of the change. Each value in the broader API carries a citation to its official primary source, an effective date, a last-confirmed date, and a staleness flag.","failureModes":["Invalid or missing 'since' date parameter returns an error","Unsupported country code returns an error or empty result","No changes since the specified date returns an empty changes array","Stale data if the source has not been re-confirmed recently (flagged via staleness field)","Payment failure (x402 protocol) if USDC is not provided or insufficient"],"whenToPreferThis":"Choose this endpoint when you need to detect which government reference data series have been updated since a specific date, rather than fetching current values directly. It is ideal for change-detection workflows, compliance monitoring, and cache invalidation — use it to poll for updates and then fetch only the changed series in detail. Prefer it over querying individual series endpoints when you don't know which data has changed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T06:45:22.857Z","isFirstParty":false,"canonicalSlug":"usaref-changes-feed-north-american-government-reference-data-b844e70d"}