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

> For AI agents: this page is also Markdown at [/developers/check-eligibility.md](https://www.hsatrackr.com/developers/check-eligibility.md). Every docs page is listed in [/developers/llms.txt](https://www.hsatrackr.com/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.

```http
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

```bash
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.

```json
{
  "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](https://www.hsatrackr.com/openapi.json). All endpoints: [API overview](https://www.hsatrackr.com/developers).