Get Single Expense Detail: GET /api/v1/eligible/{slug}
For AI agents: this page is also Markdown at /developers/get-eligible-expense.md. Every docs page is listed in /developers/llms.txt.
Retrieve detailed information about a specific HSA-eligible expense, including FAQs, related expenses, and special considerations.
GET /api/v1/eligible/{slug}Parameters
| Name | In | Required | Default | Description |
|---|---|---|---|---|
slug | path | yes | Expense slug identifier (e.g., 'lasik', 'chiropractor', 'covid-tests') |
Example request
curl "https://www.hsatrackr.com/api/v1/eligible/lasik"Example response
A real response from the live handler, with each list cut to two items.
{
"data": {
"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."
}
},
"meta": {
"source": "https://www.hsatrackr.com/eligible/lasik",
"citation_url": "https://www.hsatrackr.com/eligible/lasik",
"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 |
|---|---|---|---|
slug | string | yes | |
name | string | yes | |
category | "medical" / "dental" / "vision" / "pharmacy" / "mental-health" / "lab-tests" / "preventive-care" / "equipment-supplies" | yes | |
eligibility | "eligible" / "partially" / "ineligible" | yes | partially = eligible only with conditions (see requirements and conditionalEvidenceTypes) |
description | string | yes | |
details | string | yes | |
requirements | string or null | yes | Conditions for partially eligible items, or null |
conditionalEvidenceTypes | "prescription" / "letter_of_medical_necessity" / "physician_order" / "medical_necessity_statement" / "service_animal_documentation" / "care_plan" / "policy_or_coverage_document" / "treatment_and_legal_records" / "appointment_records" / "medical_cost_allocation" / "membership_agreement"[] | no | Proof to keep for partially eligible items |
commonCost | string | yes | |
faqs | object[] | yes | |
relatedSlugs | string[] | yes | |
seoTitle | string | no | |
seoDescription | string | no | |
sourceBasis | SourceBasis[] | no | Primary sources behind the ruling. Missing when not yet sourced. |
benefitCallout | object | no |
Errors
| Status | Meaning |
|---|---|
404 | Resource not found |
429 | Rate limit exceeded (30 requests per minute per IP) |
Full contract: openapi.json. All endpoints: API overview.