# Usaref Country Brief - North America

> Usaref Country Brief - North America is a paid API for AI agents from usaref.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-19).

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.

## Facts

- Endpoint: GET https://usaref.dev/v1/brief/:country?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usaref-country-brief-north-america-5e57c619
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ht1vPci6TphKoTvlfhy9M

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-country-brief-north-america-5e57c619
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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

## Output

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.

## 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",
     "properties": {},
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usaref-country-brief-north-america-5e57c619/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)