# Retrieve a list of products

🚦 Rate Limit: 100 requests / minute

Endpoint: GET /products
Version: 1.2.0
Security: BearerAuth

## Query parameters:

  - `modifiedFromDate` (string)
    Filter products modified from this date (ISO 8601 format). Optional - if not provided, no date filtering is applied.
    Example: "2025-05-01T00:00:00Z"

  - `modifiedToDate` (string)
    Filter products modified up to this date (ISO 8601 format). Cannot be specified without modifiedFromDate.
    Example: "2025-05-31T23:59:59Z"

  - `offset` (integer)
    Number of records to skip for pagination (default: 0)

  - `pageSize` (integer)
    Number of records to return per page (default: 1000, max: 1000)
    Example: 50

## Response 200 fields (application/json):

  - `data` (array)

  - `data.id` (string)
    Example: "f4a71b9d-17a9-4100-8110-46e133d6fc1b"

  - `data.product_name` (string)
    Example: "Black Lodge Pinot Noir 2021"

  - `data.created_at` (string)
    Example: "2024-08-20T10:30:00Z"

  - `data.updated_at` (string)
    Example: "2024-09-10T14:22:00Z"

  - `data.last_modified_at` (string)
    Example: "2024-09-10T14:22:00Z"

  - `data.product_description` (string)
    Example: "Elegant aromas of cherry, raspberry, and subtle oak with notes of the supernatural. Aged in the mystical cellars of Twin Peaks."

  - `data.tags` (array)
    Example: ["limited_release","black_lodge"]

  - `data.status` (string)
    Example: "active"

  - `data.published_status` (string)
    Example: "published"

  - `data.published_at_date` (string)
    Example: "2024-09-10"

  - `data.published` (string)
    Example: "true"

  - `data.alcohol_by_volume` (number)
    Example: 14.2

  - `data.vintage` (string)
    Example: "2021"

  - `data.varietal` (string)
    Example: "Pinot Noir"

  - `data.harvest_date` (string)
    Example: "2021-09-27"

  - `data.acid` (string)
    Example: "5.8 g/L"

  - `data.bottle_date` (string)
    Example: "2023-02-07"

  - `data.pairing_notes` (string)
    Example: "Cherry pie, wild mushroom risotto, grilled salmon"

  - `data.tasting_notes` (string)
    Example: "Velvety texture, bright red-fruit flavors, subtle spice finish with hints of the cherry"

  - `data.min_inventory` (integer)
    Example: 25

  - `data.page_title` (string)
    Example: "Black Lodge Pinot Noir 2021 | Corksy Wines"

  - `data.meta_description` (string)
    Example: "Discover our award-winning Black Lodge Pinot Noir 2021, crafted from premium Twin Peaks vineyards."

  - `data.url_handle` (string)
    Example: "black-lodge-pinot-noir-2021"

  - `data.wine_making_notes` (string)
    Example: "Fermented in small open-top tanks; 18 months in French oak (30% new). Aged in the mystical cellars of Twin Peaks."

  - `data.vintage_notes` (string)
    Example: "Cool spring and warm summer resulted in balanced acidity and supernatural complexity."

  - `data.is_available_for_pos` (boolean)
    Example: true

  - `data.is_available_for_online_store` (boolean)
    Example: true

  - `data.exclusive_for_wine_club` (boolean)

  - `data.pos_title` (string)
    Example: "BL PN 2021"

  - `data.upc_code` (string)
    Example: "012345678912"

  - `data.product_type_name` (string)
    Example: "Wine"

  - `data.brand_name` (string)
    Example: "Corksy"

  - `data.product_variants` (object)
    JSON object containing product variant information

  - `data.inventory_items` (object)
    JSON object containing inventory item information

  - `data.bundles` (array)
    Array of product bundles

  - `data.bundles.quantity` (integer)
    Example: 2

  - `data.bundles.variants` (array)

  - `data.bundles.variants.name` (string)
    Example: "750ml Bottle"

  - `data.bundles.variants.sku` (string)
    Example: "BL-PN-2021-750"

  - `data.bundles.variants.price` (number)
    Example: 42

  - `data.appellation` (string)
    Example: "Willamette Valley AVA"

  - `data.sizes` (array)
    Array of available sizes

  - `data.sizes.size` (string)
    Example: "750"

  - `data.sizes.unit` (string)
    Example: "ml"

  - `data.images` (array)
    Array of product images

  - `data.images.src` (string)
    Example: "https://example.com/images/product.jpg"

  - `pagination` (object)

  - `pagination.current_offset` (integer)

  - `pagination.page_size` (integer)
    Example: 50

  - `pagination.total_records` (integer)
    Example: 1250

  - `pagination.total_pages` (integer)
    Example: 25

  - `pagination.current_page` (integer)
    Example: 1

  - `pagination.pages_remaining` (integer)
    Example: 24

  - `pagination.has_next_page` (boolean)
    Example: true

  - `pagination.has_previous_page` (boolean)