# Search HSA-Eligible Expenses: GET /api/v1/eligible

> For AI agents: this page is also Markdown at [/developers/list-eligible-expenses.md](https://www.hsatrackr.com/developers/list-eligible-expenses.md). Every docs page is listed in [/developers/llms.txt](https://www.hsatrackr.com/developers/llms.txt).

Search and filter every canonical HSA expense eligibility decision (the total is in data.pagination.total).

```http
GET /api/v1/eligible
```

Returns paginated results with eligible, partially eligible, and ineligible status, typical costs, and documentation requirements.

## Parameters

| Name | In | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `search` | query | no |  | Search term (name or description) |
| `category` | query | no |  | Filter by expense category. One of: medical, dental, vision, pharmacy, mental-health, lab-tests, preventive-care, equipment-supplies. |
| `eligibility` | query | no |  | Filter by eligibility status One of: eligible, partially, ineligible. |
| `limit` | query | no |  | Results per page, 1 to 100. Omit to get every match. |
| `offset` | query | no | `0` | Number of results to skip for pagination |

## Example request

```bash
curl "https://www.hsatrackr.com/api/v1/eligible?search=lasik&category=vision"
```

## Example response

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

```json
{
  "data": {
    "expenses": [
      {
        "slug": "lasik",
        "name": "LASIK Eye Surgery",
        "category": "vision",
        "eligibility": "eligible",
        "description": "LASIK and other corrective eye surgery is HSA-eligible.",
        "details": "LASIK, PRK, SMILE, and other laser vision correction surgeries are qualified medical expenses. Pre-operative consultations, the surgery itself, and post-operative care visits are all eligible. Enhancement or touch-up procedures also qualify. Medicated eye drops prescribed after surgery are a separate eligible expense.",
        "requirements": "Must be performed by a licensed ophthalmologist or eye surgeon. A pre-operative exam confirming candidacy is standard.",
        "commonCost": "$2,000–$4,000 per eye",
        "faqs": [
          {
            "question": "Is LASIK HSA-eligible?",
            "answer": "Yes. LASIK and all corrective eye surgeries are fully HSA-eligible."
          },
          {
            "question": "Is PRK HSA-eligible?",
            "answer": "Yes. PRK and other laser vision correction procedures are eligible."
          }
        ],
        "relatedSlugs": [
          "eye-exam",
          "prescription-glasses"
        ],
        "benefitCallout": {
          "taxSavingsExample": "LASIK for both eyes at $4,000-$8,000 total - HSA saves $880-$1,760 at the 22% bracket (additional savings via FICA when paid through payroll deduction)",
          "strategyTip": "LASIK is one of the best shoebox strategy expenses. Pay out of pocket and let your HSA grow tax-free for years before reimbursing."
        }
      }
    ],
    "total": 1,
    "pagination": {
      "limit": 1,
      "offset": 0,
      "total": 1,
      "hasMore": false
    },
    "categories": [
      {
        "slug": "medical",
        "name": "Medical",
        "description": "Doctor visits, surgeries, hospital stays, and general medical care."
      },
      {
        "slug": "dental",
        "name": "Dental",
        "description": "Dental care including cleanings, fillings, braces, and oral surgery."
      }
    ]
  },
  "meta": {
    "source": "https://www.hsatrackr.com/eligible",
    "citation_url": "https://www.hsatrackr.com/eligible",
    "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 |
| --- | --- | --- | --- |
| `expenses` | EligibleExpense[] | yes |  |
| `pagination` | object | yes |  |
| `total` | integer | yes | Matches before pagination |
| `categories` | object[] | yes |  |

## 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).