# HSA Trackr API

> A free, read-only JSON API for HSA eligibility rulings, IRS contribution limits, provider fees, state tax rules and HSA calculators. No API key.

Base URL https://www.hsatrackr.com/api/v1. CORS open, 30 requests per minute per IP. OpenAPI 3: https://www.hsatrackr.com/openapi.json

## Docs

- [HSA Trackr API](https://www.hsatrackr.com/developers.md): A free, read-only JSON API for HSA eligibility rulings, IRS contribution limits, provider fees, state tax rules and HSA calculators. No API key.
- [Eligibility data](https://www.hsatrackr.com/developers/eligibility-data.md): What the 233 eligibility rulings mean, how matching works, and how many link a source.
- [Errors and rate limits](https://www.hsatrackr.com/developers/errors-and-rate-limits.md): Status codes, the error body, and how the 30 requests per minute limit works.

## Endpoints

- [API Documentation Index: GET /api/v1](https://www.hsatrackr.com/developers/get-api-index.md): Returns documentation and list of all available endpoints.
- [HSA Contribution Limits: GET /api/v1/limits](https://www.hsatrackr.com/developers/get-contribution-limits.md): Get HSA contribution limits, HDHP minimum requirements, and out-of-pocket maximums for a specific year.
- [Search HSA-Eligible Expenses: GET /api/v1/eligible](https://www.hsatrackr.com/developers/list-eligible-expenses.md): Search and filter every canonical HSA expense eligibility decision (the total is in data.pagination.total).
- [Check One Item: GET /api/v1/eligible/check](https://www.hsatrackr.com/developers/check-eligibility.md): Answer one question: is this item HSA eligible? Returns the best matching ruling, how strong the match is, up to 3 alternatives, and the sources behind the ruling.
- [Get Single Expense Detail: GET /api/v1/eligible/{slug}](https://www.hsatrackr.com/developers/get-eligible-expense.md): Retrieve detailed information about a specific HSA-eligible expense, including FAQs, related expenses, and special considerations.
- [Search Glossary Terms: GET /api/v1/glossary](https://www.hsatrackr.com/developers/list-glossary-terms.md): Search and filter HSA-related glossary terms and definitions.
- [Get Single Glossary Term: GET /api/v1/glossary/{slug}](https://www.hsatrackr.com/developers/get-glossary-term.md): Retrieve detailed information about a specific HSA glossary term.
- [List HSA Providers: GET /api/v1/providers](https://www.hsatrackr.com/developers/list-providers.md): Get list of major HSA custodian providers with fee structures, investment options, and key features.
- [Get Single Provider Detail: GET /api/v1/providers/{slug}](https://www.hsatrackr.com/developers/get-provider.md): Retrieve detailed information about a specific HSA custodian provider.
- [Compare Providers: GET /api/v1/providers/compare](https://www.hsatrackr.com/developers/compare-providers.md): Side-by-side comparison of multiple HSA providers.
- [Get State HSA Tax Guide: GET /api/v1/states/{slug}](https://www.hsatrackr.com/developers/get-state-guide.md): Retrieve state-specific HSA tax information.
- [Tax Savings Calculator: GET /api/v1/calculator/tax-savings](https://www.hsatrackr.com/developers/calculate-tax-savings.md): Calculate projected tax savings from HSA contributions based on tax bracket and years of contribution.
- [HSA vs Cash Cost Comparison: GET /api/v1/calculator/hsa-vs-cash/{procedure}](https://www.hsatrackr.com/developers/calculate-hsa-vs-cash.md): Compare the cost of paying for a medical procedure with HSA funds vs out-of-pocket cash, including tax impact over time.
- [Form 8889 Deduction Calculator: GET /api/v1/calculator/form-8889](https://www.hsatrackr.com/developers/calculate-form8889.md): Calculate HSA deduction amounts for IRS Form 8889 filing based on coverage type and contributions.