# Usaref Compare: North American Government Reference Series

> Usaref Compare: North American Government Reference Series is a paid API for AI agents from usaref.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-29).

Compares a single government reference series (e.g. VAT, policy rate, minimum wage, CPI, corporate tax) across up to 10 North American countries in one call, each value cited to its official source with effective and last-confirmed dates

## Facts

- Endpoint: GET https://usaref.dev/v1/compare?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usaref-compare-north-american-government-reference-series-4c4d2e9b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4hyykKQHXZR2VgbgRVdcZ

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability usaref-compare-north-american-government-reference-series-4c4d2e9b
```

Example prompt: Can you compare the VAT rates for the US, Canada, and Mexico side by side, with the official source and effective date for each?

## When to prefer this

Choose this endpoint when you need to compare a single government economic or fiscal reference series across multiple North American countries simultaneously with full citation metadata. It is superior to making individual per-country calls when you need a side-by-side view. Prefer it over general web search when you need machine-readable, officially cited, structured data rather than scraped or unverified figures.

## Known failure modes

- Invalid series identifier returns an error — only catalog-listed series IDs are accepted
- More than 10 country codes in a single request is rejected
- Non-North-American ISO country codes may return empty or error responses
- Data may lag behind very recent government announcements if not yet confirmed
- Missing required query params (series or countries) returns a validation error

## How this service works

Compare one government reference series (VAT, policy rate, minimum wage, CPI, corporate tax...) across up to 10 North American countries in one call, each row cited to its official source with effective and last-confirmed dates

## Output

A structured JSON array with one row per requested country, each containing the current value for the specified series, the official government source URL it was cited from, the date the value became effective, and the date it was last confirmed — all in a single response.

## Request schema (JSON Schema)

```json
{
 "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",
     "required": [
      "series",
      "countries"
     ],
     "properties": {
      "series": {
       "type": "string",
       "description": "One series id from GET /catalog, e.g. vat, policy-rate, minimum-wage, corporate-tax"
      },
      "countries": {
       "type": "string",
       "description": "Comma-separated ISO 3166-1 alpha-2 codes on this brand, at most 10"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usaref-compare-north-american-government-reference-series-4c4d2e9b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from usaref.dev](https://www.zero.xyz/host/usaref.dev/llms.txt)