# usaref Income Tax Rate Lookup

> usaref Income Tax Rate Lookup is a paid API for AI agents from usaref.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Returns authoritative North American income tax reference data for Canada or the United States as clean JSON with official citations and staleness flags

## Facts

- Endpoint: GET https://usaref.dev/v1/answers/income-tax
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usaref-income-tax-rate-lookup-672d6f96
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_V-2b6tQkcv3_K0y6UzIue

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-income-tax-rate-lookup-672d6f96
```

Example prompt: Can you look up the current official income tax rate for Canada, including the effective date and a link to the primary government source?

## When to prefer this

Choose this endpoint when you need a machine-readable, cited, and staleness-flagged income tax rate for Canada or the US, particularly for compliance, audit, or financial applications that require traceability to an official primary source. Prefer it over general web search when you need structured JSON output with an effective date and authoritative citation rather than a narrative answer.

## Known failure modes

- Invalid or unsupported country code returns an error or empty response
- Rate data may be flagged as stale if not recently reconfirmed against official sources
- Malformed input schema may result in unexpected query behavior given the loose input schema definition
- Service may be unavailable causing HTTP errors
- Data may lag behind very recent government announcements until next update cycle

## How this service works

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.

## Output

A JSON object containing the income tax rate value, unit (e.g. percent), country code, series identifier, effective date, last confirmed date, a boolean staleness flag, notes explaining the rate context, and a source object with the official government URL and name. Also includes a disclaimer about independent service status.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "unit": "percent",
  "notes": "The 15 July 2026 release states verbatim: 'The Bank of Canada today held its target for the overnight rate at 2.25%, with the Bank Rate at 2.5% and the deposit rate at 2.20%.' effective_from is 2025-10-29, the date of the last CHANGE (a 25 bp cut from 2.50% to 2.25%), not the date of the most recent reaffirmation — the Bank has since held at 2.25% at all SIX subsequent fixed announcement dates: 10 December 2025, 28 January 2026, 18 March 2026, 29 April 2026, 10 June 2026 and 15 July 2026. The full 2026 FAD schedule published by the Bank in August 2025 is 28 January, 18 March, 29 April, 10 June, 15 July, 2 September, 28 October and 9 December, with the Monetary Policy Report released alongside the January, April, July and October decisions. Canada's operating band is 25 bp wide: the Bank Rate (upper limit, standing liquidity facility) is the target +25 bp = 2.50%, and the deposit rate (lower limit, remuneration on settlement balances) is 2.20% — 5 bp below target, a spread the Bank narrowed from the earlier target-minus-25bp convention. The target for the overnight rate is the correct headline policy rate; do not substitute the Bank Rate. Next scheduled fixed announcement date: 2 September 2026. bankofcanada.ca serves clean HTML and is reliably fetchable.",
  "stale": false,
  "value": 2.25,
  "series": "policy-rate",
  "source": {
   "url": "https://www.bankofcanada.ca/2026/07/fad-press-release-2026-07-15/",
   "name": "Bank of Canada, Fixed Announcement Date press release 15 July 2026, 'Bank of Canada maintains the policy rate at 2¼%' (decision under the Bank of Canada Act, RSC 1985, c. B-2); rate level set by the FAD press release of 29 October 2025"
  },
  "country": "CA",
  "disclaimer": "Independent service, not affiliated with any government. Verify against the cited official source before legal or financial use.",
  "effective_from": "2025-10-29",
  "last_confirmed": "2026-07-20"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usaref-income-tax-rate-lookup-672d6f96/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)
