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