---
title: "List products"
method: GET
path: "/v2/products"
tags: ["products"]
---

# List products

`GET /v2/products`

<aside class="access" aria-label="Endpoint access">
      <table class="access__table">
        <thead>
          <tr>
            <th class="access__table-header">Products</th>
            <th class="access__table-header">Plans</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td class="access__table-cell access__product">
              <img class="access__logo" src="/static/logos/shipstation-api-logo.svg" alt="ShipStation API Logo" loading="lazy" decoding="async"/>
              <div class="access__sub">Formerly ShipEngine</div>
            </td>
            <td class="access__table-cell access__plans">
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-api-free.md" class="access__plan access__plan--off">Free</a>
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-api-advanced-enterprise.md" class="access__plan">Advanced</a>
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-api-advanced-enterprise.md" class="access__plan">Enterprise</a>
            </td>
          </tr>
          <tr>
            <td class="access__table-cell">
              <img class="access__logo" src="/static/logos/shipstation-logo.svg" alt="ShipStation Logo" loading="lazy" decoding="async"/>
            </td>
            <td class="access__table-cell access__plans">
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-free-starter.md" class="access__plan access__plan--off">Free</a>
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-free-starter.md" class="access__plan access__plan--off">Starter</a>
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-standard-premium.md" class="access__plan">Standard</a>
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-standard-premium.md" class="access__plan">Premium</a>
            </td>
          </tr>
        </tbody>
      </table>
      <footer class="access__footer">
        <a class="access__help" href="/apis/@shipstation-v2/docs/getting-started/products-and-plans.md">
          Learn about products and plans
          <img src="/static/icons/external-link.svg" alt="External Link Icon" style="width: 16px;" loading="lazy" decoding="async"/>
        </a>
      </footer>
    </aside>

## Query parameters

- `sku` string
- `name` string
- `active` boolean
- `page_size` integer
- `page` integer

## Response `200`

List of products

- object
  - `products` Product[]
    - `product_id` integer — Unique identifier for the product
    - `sku` string — Stock Keeping Unit identifier
    - `name` string — Product name
    - `upc` string, nullable — Universal Product Code
    - `thumbnail_url` string, nullable — URL to product thumbnail image
    - `price` object
      - `currency` string — Currency code
      - `amount` number — Price amount
    - `dimensions` object
      - `unit` string — Unit of measurement
      - `length` number — Length dimension
      - `width` number — Width dimension
      - `height` number — Height dimension
    - `weight` object
      - `value` number — Weight value
      - `unit` string — Weight unit
    - `internal_notes` string, nullable — Internal notes about the product
    - `fulfillment_sku` string, nullable — Fulfillment SKU
    - `create_date` string, date-time — Date when product was created
    - `modify_date` string, date-time — Date when product was last modified
    - `active` boolean — Whether the product is active
    - `product_category` object, nullable
      - `product_category_id` integer
      - `name` string
    - `preset_group` string, nullable — Preset group
    - `warehouse_location` string, nullable — Warehouse location
    - `default_carrier_code` string, nullable — Default carrier code
    - `default_service_code` string, nullable — Default service code
    - `default_package_code` string, nullable — Default package code
    - `default_intl_carrier_code` string, nullable — Default international carrier code
    - `default_intl_service_code` string, nullable — Default international service code
    - `default_intl_package_code` string, nullable — Default international package code
    - `default_confirmation` string, nullable — Default confirmation type
    - `default_intl_confirmation` string, nullable — Default international confirmation type
    - `customs_description` string, nullable — Customs description
    - `customs_value` number, nullable — Customs value
    - `customs_tariff_no` string, nullable — Customs tariff number
    - `customs_country_code` string, nullable — Customs country code
    - `no_customs` boolean, nullable — Whether customs is required
    - `tags` object[], nullable
      - `tag_id` integer
      - `name` string
      - `color` string
    - `aliases` object[], nullable
      - `store_id` integer
      - `sku_alias` string
    - `product_type` string, nullable — Product type
    - `is_returnable` boolean — Whether the product is returnable
    - `should_override_name` boolean, nullable — Whether to override the product name
    - `is_bundle` boolean, nullable — Whether the product is a bundle
    - `bundle_components` object[], nullable
      - `bundle_product_id` integer
      - `component_product_id` integer
      - `sku` string
      - `quantity` integer
      - `active` boolean
    - `auto_split_option` string — Auto split option
    - `auto_split_custom_quantity` integer, nullable — Auto split custom quantity
  - `total` integer — Total number of products
  - `page` integer — Current page number
  - `pages` integer — Total number of pages
  - `links` object
    - `first` object
      - `href` string — URL to the first page
    - `last` object
      - `href` string — URL to the last page
    - `prev` object
      - `href` string — URL to the previous page
    - `next` object
      - `href` string — URL to the next page

## Other responses

- `400` — The request contained errors.
- `404` — The specified resource does not exist.
- `500` — The request was successful.

---

[API](https://skmtc.net/shipstation/apis/shipstation-api-v2.md) · [All operations](https://skmtc.net/shipstation/apis/shipstation-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shipstation/shipstation-api-v2/revisions/d3d8c21cd227/schema)