{
  "name": "TaxNotes.ca public API",
  "version": "1",
  "description": "Canadian tax figures (federal, provincial and territorial, from the CRA; Quebec from Revenu Québec), the same income tax calculator as the website, and plain-language guides. Read-only, JSON, no sign-in.",
  "documentation": {
    "openapi": "https://taxnotes.ca/api/v1/openapi.json",
    "forAi": "https://taxnotes.ca/for-ai/"
  },
  "endpoints": [
    {
      "method": "GET",
      "path": "/api/v1/",
      "description": "This index."
    },
    {
      "method": "GET",
      "path": "/api/v1/openapi.json",
      "description": "OpenAPI 3.1 description of every endpoint."
    },
    {
      "method": "GET",
      "path": "/api/v1/figures",
      "description": "One tax figure by dot path, a whole section, or (with neither) the list of sections.",
      "examples": [
        "https://taxnotes.ca/api/v1/figures?year=2025&path=federal.basicPersonal.max",
        "https://taxnotes.ca/api/v1/figures?year=2025&section=provinces.ON",
        "https://taxnotes.ca/api/v1/figures?year=2025"
      ]
    },
    {
      "method": "POST",
      "path": "/api/v1/calculate",
      "description": "Income tax, CPP/QPP, EI and QPIP for one person, from the same engine as the website calculator.",
      "example": {
        "year": 2025,
        "province": "ON",
        "employment": 75000,
        "rrspContribution": 5000
      }
    },
    {
      "method": "GET",
      "path": "/api/v1/guides",
      "description": "Every guide, optionally filtered by audience and topic.",
      "examples": [
        "https://taxnotes.ca/api/v1/guides",
        "https://taxnotes.ca/api/v1/guides?audience=individuals&topic=saving"
      ]
    },
    {
      "method": "GET",
      "path": "/api/v1/guides/{slug}",
      "description": "One guide: details and the full text as Markdown.",
      "examples": [
        "https://taxnotes.ca/api/v1/guides/rrsp-basics"
      ]
    },
    {
      "method": "GET",
      "path": "/api/v1/changes",
      "description": "Recent changes to the site and its figures, newest first.",
      "examples": [
        "https://taxnotes.ca/api/v1/changes?limit=10"
      ]
    }
  ],
  "taxYears": [
    2025,
    2026
  ],
  "currentTaxYear": 2025,
  "rateLimits": {
    "calculate": "60 requests per minute per client (POST /api/v1/calculate and the MCP calculate_income_tax tool)",
    "reads": "300 requests per minute per client (every other /api/v1 request and every /mcp request)",
    "whenExceeded": "HTTP 429 with a Retry-After header (seconds).",
    "bodyLimit": "16 KB"
  },
  "cors": "Any origin (Access-Control-Allow-Origin: *). No credentials.",
  "privacy": "No sign-in, no API key and no cookies. Inputs (including incomes) are used only to answer the request: never logged, never stored.",
  "data": {
    "index": "https://taxnotes.ca/data/v1/index.json",
    "years": [
      "https://taxnotes.ca/data/v1/2025.json",
      "https://taxnotes.ca/data/v1/2026.json"
    ],
    "schema": "https://taxnotes.ca/data/v1/schema.json"
  },
  "llms": {
    "index": "https://taxnotes.ca/llms.txt",
    "full": "https://taxnotes.ca/llms-full.txt",
    "guideMarkdown": "https://taxnotes.ca/guides/{slug}.md"
  },
  "mcp": {
    "url": "https://taxnotes.ca/mcp",
    "transport": "Streamable HTTP (stateless, JSON responses)",
    "connect": "claude mcp add --transport http taxnotes https://taxnotes.ca/mcp",
    "tools": [
      "get_tax_figure",
      "get_tax_year_section",
      "calculate_income_tax",
      "search_guides",
      "get_guide",
      "list_recent_changes"
    ]
  },
  "changes": {
    "page": "https://taxnotes.ca/changes/",
    "atom": "https://taxnotes.ca/changes/feed.xml",
    "json": "https://taxnotes.ca/changes/feed.json"
  },
  "license": {
    "name": "Creative Commons Attribution 4.0 International",
    "spdx": "CC-BY-4.0",
    "url": "https://creativecommons.org/licenses/by/4.0/",
    "terms": "https://taxnotes.ca/reproducing-our-content/",
    "attribution": "Credit TaxNotes.ca and link to the page or data you used (https://taxnotes.ca/); please also cite the official source listed in `sources`.",
    "excludes": "The TaxNotes.ca name and logo, and the site's code."
  },
  "cite": "Cite TaxNotes.ca with the page or data URL, and the official CRA or Revenu Québec source listed in `sources`.",
  "disclaimer": "General information, not personal tax, legal or investment advice. Check with a qualified professional before acting."
}