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

NameInRequiredDefaultDescription
slugpathyesExpense 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.

FieldTypeAlways presentDescription
slugstringyes
namestringyes
category"medical" / "dental" / "vision" / "pharmacy" / "mental-health" / "lab-tests" / "preventive-care" / "equipment-supplies"yes
eligibility"eligible" / "partially" / "ineligible"yespartially = eligible only with conditions (see requirements and conditionalEvidenceTypes)
descriptionstringyes
detailsstringyes
requirementsstring or nullyesConditions 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"[]noProof to keep for partially eligible items
commonCoststringyes
faqsobject[]yes
relatedSlugsstring[]yes
seoTitlestringno
seoDescriptionstringno
sourceBasisSourceBasis[]noPrimary sources behind the ruling. Missing when not yet sourced.
benefitCalloutobjectno

Errors

StatusMeaning
404Resource not found
429Rate limit exceeded (30 requests per minute per IP)

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