{"uid":"cap_1scgaUyrWr5tQq7XkWy54","slug":"usaref-changes-feed-north-american-government-reference-data-b844e70d","name":"usaref Changes Feed – North American Government Reference Data","description":"Authoritative North American government reference values as clean JSON: central-bank policy rates, VAT rates, national minimum wages and public holidays for Canada (ca), United States (us). Every value carries a citation to its official primary source (government gazette or central-bank statement), an effective date, a last-confirmed date and a staleness flag.","url":"https://usaref.dev/v1/changes","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-09-14T00:40:46.534Z","isFirstParty":false}