Skip to main content
POST
/
v2
/
products
/
check-eligibility
Check Eligibility
curl --request POST \
  --url https://api.example.com/v2/products/check-eligibility

Documentation Index

Fetch the complete documentation index at: https://docs.withgale.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Check Eligibility

Check if a product is HSA/FSA eligible using its UPC code or name, without creating a product. Useful for pre-validation during product import or catalog setup.

​
Authentication

Authorization: Bearer glm_test_YOUR_API_KEY

​
Request Body

{
  "upc_code_or_gtin": "14567890123456",
  "product_name": "Digital Blood Pressure Monitor"
}

​
Parameters

At least one parameter is required:
ParameterTypeRequiredDescription
upc_code_or_gtinstringNo*UPC or GTIN barcode
product_namestringNo*Product name
*At least one of upc_code_or_gtin or product_name must be provided. UPC is more accurate.

​
Request

POST /v2/products/check-eligibility

​
Response

{
  "hsa_fsa_eligible": true,
  "message": "SIGIS verified - Medical device",
  "checked_at": "2025-10-18T14:30:00Z",
  "upc_code_or_gtin": "14567890123456",
  "product_name": "Digital Blood Pressure Monitor"
}

​
Response Fields

FieldTypeDescription
hsa_fsa_eligiblebooleanWhether product is HSA/FSA eligible
messagestringExplanation of eligibility status
checked_attimestampWhen eligibility was checked

​
Examples

curl -X POST https://api.withgale.com/v2/products/check-eligibility \
  -H "Authorization: Bearer glm_test_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "upc_code_or_gtin": "14567890123456",
    "product_name": "Digital Blood Pressure Monitor"
  }'

​
Not Eligible Response

{
  "hsa_fsa_eligible": false,
  "message": "Product not found in SIGIS database. May not be HSA/FSA eligible or requires manual review.",
  "checked_at": "2025-10-18T14:30:00Z",
  "upc_code_or_gtin": "99999999999999",
  "product_name": "Regular Consumer Product"
}

​
Dual-Purpose Products

Some products require a Letter of Medical Necessity (LMN): 
{
  "hsa_fsa_eligible": true,
  "message": "Eligible with Letter of Medical Necessity (LMN). Customer must provide doctor's note.",
  "checked_at": "2025-10-18T14:30:00Z",
  "product_name": "Vitamin D Supplements"
}

​
Rate Limits

  • Test mode: 100 requests/minute
  • Live mode: 1000 requests/minute
For bulk checking, add 100ms delay between requests.

​
Errors

Status CodeError CodeDescription
400invalid_requestMissing both UPC and product name
401unauthorizedInvalid or missing API key
422validation_errorInvalid UPC format
429rate_limit_exceededToo many requests
Example error: 
{
  "error": {
    "code": "invalid_request",
    "message": "Either upc_code_or_gtin or product_name must be provided"
  }
}

​
Important Notes

Eligibility can change. SIGIS database updates monthly. Re-check eligibility periodically for existing products.
Not a guarantee. Eligibility check indicates SIGIS database status. Final determination depends on customer’s HSA/FSA administrator.