---
title: "Retrieve all Products."
method: GET
path: "/products.json"
tags: ["Products"]
---

# Retrieve all Products.

`GET /products.json`

## Query parameters

- `limit` integer
- `page` integer
- `locale` string, string
- `fields` string, string

## Response `200`

OK

- Product[]
  - `product` ProductFields
    - `id` integer — Unique identifier of the product
    - `name` string — Name of the product
    - `page_title` string — SEO title of the product
    - `description` string — Description of the product
    - `type` string — Type of the product (physical, digital or gift_card)
    - `days_to_expire` integer — Number of days after the purchase date that the gift card will remain valid
    - `price` number, float — Price of the product
    - `discount` number, float — Discount of the product
    - `weight` number, float — Weight of the product
    - `stock` integer — Quantity in stock for the product
    - `stock_unlimited` boolean — True if the Product has unlimited stock
    - `stock_threshold` integer — Low stock threshold quantity.
    - `stock_notification` boolean — True if the Product has low stock threshold quantity enabled
    - `back_in_stock_enabled` boolean — True if email alerts for customers when this product is restocked are enabled
    - `cost_per_item` number — Cost per item of the product (only you can see this).
    - `compare_at_price` number — Used to show a sale price. Value must be higher than the price.
    - `sku` string — Stock Keeping Unit of the product
    - `brand` string — Brand of the product
    - `barcode` string — Barcode of the product
    - `google_product_category_text` string — Human-readable label for the Google product taxonomy category
    - `quotable` boolean — True if the product can be quoted
    - `featured` boolean — True if the product is featured
    - `reviews_enabled` boolean — True if the customer reviews are enabled for this product
    - `status` 'available' | 'not-available' | 'disabled' — Status of the product
    - `created_at` string — Date of product creation
    - `updated_at` string — Date of the last product update
    - `package_format` 'box' | 'cylinder' — Format the product package
    - `length` number, float — Length of the product
    - `width` number, float — Width of the product
    - `height` number, float — Height of the product
    - `diameter` number, float — Diameter of the product
    - `permalink` string — Product unique URL path
    - `categories` CategoryFields[]
      - `id` integer — Unique identifier of the Category
      - `name` string — Name of the Category
      - `parent_id` integer — Unique identifier of the Parent Category
      - `permalink` string — Category unique URL path
    - `images` ImageFields[]
      - `id` integer — Unique identifier of the image
      - `position` integer — Position of the image
      - `url` string — Complete URL of the image
    - `variants` VariantFields[]
      - `id` integer — Unique identifier of the product
      - `price` number, float — Price of the product
      - `sku` string — Stock Keeping Unit of the Product's Variant
      - `barcode` string — Barcode of the Product's Variant
      - `stock` integer — Quantity in stock for the Product's Variant
      - `stock_unlimited` boolean — True if the Product's Variant has unlimited stock
      - `stock_threshold` integer — Low stock threshold quantity.
      - `stock_notification` boolean — True if the Product has low stock threshold quantity enabled
      - `cost_per_item` number — Cost per item for the Product's Variant (only you can see this)
      - `compare_at_price` number — Used to show a sale price. Value must be higher than the price
      - `options` ProductOptionVariantEdit[]
        - `name` string — Name of the product option
        - `option_type` 'option' | 'color' — Type of the product option that generates variants
        - `value` string — Value of the product option
        - `custom` string — Hexadecimal value of color. Only available for product option type 'Color'
        - `product_option_position` integer — position of product option
        - `product_value_position` integer — position of product option value
      - `image` ImageFields
        - `id` integer — Unique identifier of the image
        - `position` integer — Position of the image
        - `url` string — Complete URL of the image
    - `digital_products` DigitalProductFields[]
      - `id` integer — Unique identifier of the digital product
      - `url` string — Private URL of the digital product
      - `expiration_seconds` integer — Time left in seconds before the current private URL expires
      - `external` boolean — true if it's an external link. If not present or false, it's a file

---

[API](https://skmtc.net/jumpseller/apis/jumpseller-api.md) · [All operations](https://skmtc.net/jumpseller/apis/jumpseller-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jumpseller/jumpseller-api/versions/7512c6ae3524/schema)