---
title: "Get products"
method: GET
path: "/v1/products"
tags: ["Store Catalog"]
---

# Get products

`GET /v1/products`

List products in the store catalog with pagination and optional filtering. Filter by IDs, SKUs, text search, or semantic search.

## Query parameters

- `pageIndex` integer
- `numResultsPerPage` integer
- `search` string, nullable
- `ids` string, nullable
- `skus` string, nullable

## Response `200`

OK

- ProductsPaginationOutput
  - `products` ProductOutputSerializer[], required
    - `id` string, required
    - `externalIdentifier` string, nullable — The external ID of the product from an external system
    - `sku` string, nullable — The Stock Keeping Unit (SKU) for the product
    - `name` string, required — The name of the product
    - `description` string, nullable — The description of the product
    - `imageUrls` string[], nullable — List of image URLs for the product
    - `categories` string[], nullable — List of categories the product belongs to
    - `weight` number, nullable — The weight of the product
    - `dimensions` DimensionOutputSerializer
      - `depth` number, nullable — The depth dimension of the product
      - `width` number, nullable — The width dimension of the product
      - `height` number, nullable — The height dimension of the product
    - `identifiers` IdentifierOutputSerializer[], nullable — List of identifiers for the product
      - `type` string, required — The type of identifier
      - `value` string, required — The value of the identifier
    - `attributes` string[], nullable — List of attributes for the product
    - `details` DetailsOutputSerializer
      - `weightedItemInfo` WeightedItemInfoOutputSerializer
        - `weightPerItem` number, nullable — The weight per individual item
        - `weightUnit` string, nullable — The unit of weight measurement
      - `sizeSpecification` SizeSpecificationOutputSerializer
        - `value` number, nullable — The size value
        - `description` string, nullable — Description of the size specification
      - `packSizeSpecification` PackSizeSpecificationOutputSerializer
        - `value` string, nullable — The size value
        - `description` string, nullable — Description of the size specification
    - `providerConfigs` ProviderConfigOutputSerializer[], nullable — Provider-specific configurations for this product
      - `provider` string, required — Provider name
      - `serviceType` string, required — Service type (e.g., pick_and_deliver, marketplace)
      - `categories` string[], nullable — Provider-specific categories for this product
      - `enabled` boolean, nullable — Whether this provider config is enabled
  - `totalResults` integer, required

## Other responses

- `422` — Unprocessable Content

---

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