Check One Item: GET /api/v1/eligible/check

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

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 /api/v1/eligible/check

Built for CLIs, browser extensions and integrations.

Parameters

Name	In	Required	Default	Description
`q`	query	yes		The item to check, in plain words or as a question (2 to 120 characters). Question words like "is", "can I use my HSA for" and "HSA eligible" are ignored.

Example request

curl "https://www.hsatrackr.com/api/v1/eligible/check?q=ozempic"

Example response

A real response from the live handler, with each list cut to two items.

{
  "data": {
    "query": "ozempic",
    "found": true,
    "matchQuality": "exact",
    "match": {
      "slug": "ozempic",
      "name": "GLP-1 Prescription Medications",
      "category": "pharmacy",
      "eligibility": "eligible",
      "description": "Prescribed GLP-1 medicines such as Ozempic, Wegovy, Mounjaro, and Zepbound are HSA-eligible prescription drug expenses.",
      "requirements": "Keep the valid prescription and itemized pharmacy receipt, and subtract any insurance or other reimbursement. For a compounded product, confirm that it was prescribed for you and dispensed by a state-licensed pharmacy. HSA eligibility does not establish FDA approval, product quality, or legality.",
      "sourceBasis": [
        {
          "label": "IRS Publication 502: Medicines",
          "url": "https://www.irs.gov/publications/p502",
          "supports": "Amounts paid for medicines and drugs prescribed for an individual are includible medical expenses.",
          "reviewedDate": "2026-07-14"
        },
        {
          "label": "IRS Publication 969: Qualified medical expenses",
          "url": "https://www.irs.gov/publications/p969",
          "supports": "HSA distributions are tax-free only for uncompensated qualified medical expenses incurred after the HSA was established.",
          "reviewedDate": "2026-07-14"
        }
      ],
      "url": "https://www.hsatrackr.com/eligible/ozempic"
    },
    "alternatives": [],
    "searchUrl": "https://www.hsatrackr.com/eligible?search=ozempic"
  },
  "meta": {
    "source": "https://www.hsatrackr.com/eligible/ozempic",
    "citation_url": "https://www.hsatrackr.com/eligible/ozempic",
    "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.

Field	Type	Always present	Description
`query`	string	yes	The q you sent, trimmed
`found`	boolean	yes	True only for an exact or strong match. False means no answer; check alternatives
`matchQuality`	"exact" / "strong" or null	yes	exact: name, slug or alias. strong: the name or its key words. null when found is false
`match`	EligibilityCheckItem or null	yes	The ruling that answers the question, or null when found is false
`alternatives`	EligibilityCheckItem[]	yes	Up to 3 other rulings, including weak suggestions when found is false
`searchUrl`	string	yes	The full search on hsatrackr.com for this query

Errors

Status	Meaning
`400`	Bad request - invalid parameters
`429`	Rate limit exceeded (30 requests per minute per IP)

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