---
title: "Get All Cart Products"
method: GET
path: "/cart/products"
tags: ["cart", "Products"]
---

# Get All Cart Products

`GET /cart/products`

Returns all Products for the Cart connection associated with the provided access token.

## Query parameters

- `page_token` string, nullable
- `limit` integer
- `ids` CartProductIdsQueryParam
  - `in` string[], required — A comma-separated list of resource IDs. If provided, all other query params are ignored.
- `created_date` CartProductCreatedDateQueryParam
  - `eq` string, date-time
  - `neq` string, date-time
  - `in` string[] — Comma-separated.
  - `nin` string[] — Comma-separated.
  - `gt` string, date-time
  - `gte` string, date-time
  - `lt` string, date-time
  - `lte` string, date-time
- `updated_date` CartProductUpdatedDateQueryParam
  - `eq` string, date-time
  - `neq` string, date-time
  - `in` string[] — Comma-separated.
  - `nin` string[] — Comma-separated.
  - `gt` string, date-time
  - `gte` string, date-time
  - `lt` string, date-time
  - `lte` string, date-time
- `trackstar_created_date` CartProductTrackstarCreatedDateQueryParam
  - `eq` string, date-time
  - `neq` string, date-time
  - `in` string[] — Comma-separated.
  - `nin` string[] — Comma-separated.
  - `gt` string, date-time
  - `gte` string, date-time
  - `lt` string, date-time
  - `lte` string, date-time
- `trackstar_updated_date` CartProductTrackstarUpdatedDateQueryParam
  - `eq` string, date-time
  - `neq` string, date-time
  - `in` string[] — Comma-separated.
  - `nin` string[] — Comma-separated.
  - `gt` string, date-time
  - `gte` string, date-time
  - `lt` string, date-time
  - `lte` string, date-time
- `trackstar_tags` CartProductTrackstarTagsFlatQueryParam
  - `contains` string[] — Comma-separated.
  - `not_contains` string[] — Comma-separated.
- `sku` CartProductSkuQueryParam
  - `eq` string
  - `neq` string
  - `in` string[] — Comma-separated.
  - `nin` string[] — Comma-separated.
  - `contains` string
  - `not_contains` string
  - `is_null` boolean — Filter by whether the field is null.

## Headers

- `x-trackstar-api-key` string, required
- `x-trackstar-access-token` string, required

## Response `200`

Successful response

- CartProductsListEndpoint
  - `data` CartProductApiItemSchema[], required
    - `id` string, required — The unique ID of the product.
    - `created_date` string, date-time, required — The date the cart product was created.
    - `updated_date` string, date-time, required — The date the cart product was last updated.
    - `name` string, required — The name of the product.
    - `sku` string, nullable, required — The SKU of the product.
    - `gtin` string, nullable, required — The GTIN of the product.
    - `parent_product_id` string, required — If this is a variant, the ID of the parent product. If this is a parent product, this field should be the same as ID.
    - `is_kit` boolean, required
    - `active` boolean, required — Whether the product is active.
    - `image_url` string, nullable, required — The URL of the product's image.
    - `price` number, nullable, required — The price of the product if it is a variant. Not the source of truth for parent products.
    - `unit_cost` number, nullable, required — The unit cost of the product if it is a variant. Not the source of truth for parent products.
    - `inventory` integer, nullable, required — The inventory of the product if it is a variant. Not the source of truth for parent products.
    - `inventory_by_warehouse_id` object, required — Inventory broken down by warehouse.
    - `measurements` ProductMeasurements, required
      - `length` number, nullable, required
      - `width` number, nullable, required
      - `height` number, nullable, required
      - `unit` 'cm' | 'in', nullable, required — The unit of measurement for the size of the product.
      - `weight` number, nullable, required
      - `weight_unit` 'kg' | 'oz' | 'lb', nullable, required — The unit of measurement for the weight of the product.
    - `tags` string[], required — A list of tags associated with the product. Tags that are represented as key-value pairs in the underlying system will be represented as a single string formatted as `key:value`.
    - `categories` string[], required — A list of category names the product belongs to. For platforms with a hierarchical category tree, each level is a separate element with the leaf last (e.g. ["Apparel", "Shoes", "Running"]). For platforms with a single scalar product type, a single-element list.
    - `external_system_url` string, nullable, required — URL link to the cart product in the external system (WMS/Freight etc).
    - `trackstar_tags` unknown[], nullable, required — A list of custom tags associated with the resource. A tag can be either a string or a dictionary with one key-value pair.
      - unknown
    - `additional_fields` object, required — Integration-specific fields
    - `trackstar_created_date` string, date-time, required
    - `trackstar_updated_date` string, date-time, required
  - `next_token` string, nullable, required — See [pagination](/how-to-guides/about-the-api#pagination) for more details.
  - `total_count` integer, required — The number of items returned.

## Other responses

- `422` — Validation error

---

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