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

# Product Object

> The Product object represents an item you sell, with automatic HSA/FSA eligibility detection

# Product Object

The Product object represents items in your catalog. Gale automatically determines HSA/FSA eligibility via SIGIS database integration.

<Note>All monetary amounts are integers in cents (e.g., 4995 = \$49.95).</Note>

## The Product Object

```json theme={null}
{
  "id": 12345,
  "name": "Digital Blood Pressure Monitor",
  "tagline": "FDA-approved automatic BP monitor",
  "description": "Clinically validated blood pressure monitor with Bluetooth connectivity. Features automatic inflation, irregular heartbeat detection, and memory for 200 readings. Includes carrying case and 4 AAA batteries.",
  "price": 4995,
  "currency": "USD",
  "merchant_product_id": "BP-MONITOR-001",
  "upc_code_or_gtin": "14567890123456",
  "status": "active",
  "eligibility": {
    "hsa_fsa_eligible": true,
    "message": "HSA/FSA accepted"
  },
  "images": [
    {
      "id": 567,
      "url": "https://cdn.example.com/bp-monitor-front.jpg",
      "is_primary": true
    },
    {
      "id": 568,
      "url": "https://cdn.example.com/bp-monitor-side.jpg",
      "is_primary": false
    }
  ],
  "metadata": {
    "category": "medical_devices",
    "brand": "HealthTech Pro",
    "weight": "0.5 lbs"
  },
  "created_at": "2026-02-25T14:30:00Z",
  "updated_at": "2026-02-25T14:30:00Z"
}
```

## Attributes

| Attribute | Type | Description |
| - | - | - |
| `id` | integer | Unique identifier for the product |
| `name` | string | Product name (max 255 chars) |
| `tagline` | string | Short description (max 255 chars) |
| `description` | string | Full product description (supports markdown) |
| `price` | integer | Price in cents |
| `currency` | string | ISO 4217 currency code |
| `merchant_product_id` | string | Your reference ID for this product |
| `upc_code_or_gtin` | string | UPC or GTIN barcode |
| `status` | enum | Product status: `active`, `inactive`, `archived` |
| `eligibility` | object | HSA/FSA eligibility information |
| `images` | array | Product images (max 10) |
| `metadata` | object | Custom key-value pairs |
| `created_at` | timestamp | When product was created |
| `updated_at` | timestamp | When product was last updated |

## Eligibility Object

| Field | Type | Description |
| - | - | - |
| `hsa_fsa_eligible` | boolean | Whether product is HSA/FSA eligible |
| `message` | string | Customer-facing eligibility explanation |

Gale determines eligibility automatically when you sync products. The `message` field provides a customer-facing explanation you can display on your storefront (e.g., "HSA/FSA accepted", "Requires Letter of Medical Necessity").

## Product Status

| Status | Description |
| - | - |
| `active` | Available for sale |
| `inactive` | Temporarily unavailable |
| `archived` | Removed from catalog (soft deleted) |

## Examples

### Basic Product (Required Fields Only)

```json theme={null}
{
  "name": "Digital Thermometer",
  "price": 2995,
  "currency": "USD"
}
```

### Complete Product

```json theme={null}
{
  "name": "Premium Blood Pressure Monitor",
  "tagline": "Professional-grade BP monitoring",
  "description": "Clinically validated automatic blood pressure monitor with advanced features including irregular heartbeat detection, WHO classification indicator, and Bluetooth connectivity for health app integration.",
  "price": 4995,
  "currency": "USD",
  "merchant_product_id": "BP-MONITOR-PRO",
  "upc_code_or_gtin": "14567890123456",
  "images": [
    "https://cdn.example.com/bp-monitor-1.jpg",
    "https://cdn.example.com/bp-monitor-2.jpg"
  ],
  "metadata": {
    "category": "medical_devices",
    "brand": "HealthTech",
    "features": "bluetooth,memory,irregular_detection"
  }
}
```

## Related Endpoints

* [Create Product](/api-reference/endpoint/create-product-v2) - POST /api/v2/products
* [Get Product](/api-reference/endpoint/get-product-v2) - GET /api/v2/products/{id}
* [Update Product](/api-reference/endpoint/update-product-v2) - PUT /api/v2/products/{id}
* [List Products](/api-reference/endpoint/list-products-v2) - GET /api/v2/products
* [Check Eligibility](/api-reference/endpoint/check-eligibility) - POST /api/v2/products/check-eligibility


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.