Get State HSA Tax Guide: GET /api/v1/states/{slug}

For AI agents: this page is also Markdown at /developers/get-state-guide.md. Every docs page is listed in /developers/llms.txt.

Retrieve state-specific HSA tax information.

GET /api/v1/states/{slug}

Use 'all' as slug to get full list of all states.

Parameters

Example request

curl "https://www.hsatrackr.com/api/v1/states/california"

Example response

A real response from the live handler.

{
  "data": {
    "slug": "california",
    "name": "California",
    "abbreviation": "CA",
    "taxTreatment": "none",
    "incomeTaxRate": "1%–13.3%",
    "hasStateTax": true,
    "summary": "California does NOT recognize HSA tax benefits. Contributions are taxed, and investment gains are taxable income.",
    "details": "California does not conform to federal HSA tax treatment. HSA contributions are not deductible on your California state tax return. Investment earnings within the HSA are subject to California income tax and must be reported annually. Qualified withdrawals for medical expenses are still tax-free at the federal level, but you've already been taxed on the contributions and earnings at the state level. California treats HSAs similarly to regular investment accounts for state tax purposes.",
    "notes": "California residents should track HSA investment gains for state tax reporting. Consider the state tax impact when deciding contribution amounts."
  },
  "meta": {
    "source": "https://www.hsatrackr.com/states/california",
    "citation_url": "https://www.hsatrackr.com/states/california",
    "updated": "2026-01-01",
    "disclaimer": "This information is for educational purposes only and does not constitute tax, legal, or financial advice. Consult a qualified professional for your specific situation.",
    "api_docs": "https://www.hsatrackr.com/api/v1"
  }
}

Response fields

Every response is { data, meta }. meta.citation_url is the public page to cite.

When the response is: state

When the response is: all states (slug=all)

Errors

Full contract: openapi.json. All endpoints: API overview.