---
title: "Get products"
method: GET
path: "/v2/commerce/products/{productIdCsvs}"
tags: ["Products"]
---

# Get products

`GET /v2/commerce/products/{productIdCsvs}`

## Request

- Base URL: `https://api.squarespace.com`
- URL: `https://api.squarespace.com/v2/commerce/products/{productIdCsvs}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/squarespace/apis/commerce-api/docs/v2/commerce/products/:productIdCsvs/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves information for specific products, including information for any variants or images. Up to 50 products can be retrieved per request.

## Path parameters

- `productIdCsvs` string, required

## Headers

- `Authorization` string, required
- `User-Agent` string, required

## Response `200`

The requested products.

- ProductListResponseV2
  - `products` union[]
    - union
      - DigitalProduct: A DIGITAL product.
        - `createdOn` string, date-time, required
        - `description` string
        - `id` string, required
        - `images` ProductImage[]
          - `altText` string: Alt text for the image; impacts SEO and appears in search results.
          - `availableFormats` string[]: Available image sizes. Use with `images.url` and a `format` query parameter to retrieve the image at a particular width.
          - `id` string: Unique ProductImage id.
          - `orderIndex` integer: Position of the image in the product's image list.
          - `originalSize` object: Image size when first uploaded.
          - `url` string: Absolute URL of the image hosted on Squarespace.
        - `isVisible` boolean
        - `modifiedOn` string, date-time, required
        - `name` string
        - `seoOptions` SeoOptions: Options for search engine optimization.
          - `description` string
          - `title` string
        - `storePageId` string, required
        - `tags` string[]
        - `type` 'PHYSICAL' | 'SERVICE' | 'GIFT_CARD' | 'DIGITAL', required
        - `url` string
        - `urlSlug` string
        - `digitalGood` DigitalGood: Present for DIGITAL products only.
          - `filename` string: Filename of the downloadable file.
          - `id` string: Unique DigitalGood id.
        - `pricing` ProductPricing: Present for DIGITAL products only. Digital products don't have variants, so pricing is at the product level.
          - `basePrice` MonetaryAmount: A monetary amount with currency code and decimal value.
            - `currency` object: ISO 4217 currency code.
              - …
            - `value` number: Decimal monetary value.
          - `onSale` boolean: Indicates whether the variant is sold according to its sale price. Present for PHYSICAL products only.
          - `salePrice` MonetaryAmount: A monetary amount with currency code and decimal value.
            - `currency` object: ISO 4217 currency code.
              - …
            - `value` number: Decimal monetary value.
      - GiftCardProduct: A GIFT_CARD product.
        - `createdOn` string, date-time, required
        - `description` string
        - `id` string, required
        - `images` ProductImage[]
          - `altText` string: Alt text for the image; impacts SEO and appears in search results.
          - `availableFormats` string[]: Available image sizes. Use with `images.url` and a `format` query parameter to retrieve the image at a particular width.
          - `id` string: Unique ProductImage id.
          - `orderIndex` integer: Position of the image in the product's image list.
          - `originalSize` object: Image size when first uploaded.
          - `url` string: Absolute URL of the image hosted on Squarespace.
        - `isVisible` boolean
        - `modifiedOn` string, date-time, required
        - `name` string
        - `seoOptions` SeoOptions: Options for search engine optimization.
          - `description` string
          - `title` string
        - `storePageId` string, required
        - `tags` string[]
        - `type` 'PHYSICAL' | 'SERVICE' | 'GIFT_CARD' | 'DIGITAL', required
        - `url` string
        - `urlSlug` string
        - `variants` GiftCardProductVariant[]
          - `id` string
          - `image` ProductImage: Product image assigned to the variant.
            - `altText` string: Alt text for the image; impacts SEO and appears in search results.
            - `availableFormats` string[]: Available image sizes. Use with `images.url` and a `format` query parameter to retrieve the image at a particular width.
            - `id` string: Unique ProductImage id.
            - `orderIndex` integer: Position of the image in the product's image list.
            - `originalSize` object: Image size when first uploaded.
            - `url` string: Absolute URL of the image hosted on Squarespace.
          - `pricing` SimpleProductPricing
            - `basePrice` MonetaryAmount: A monetary amount with currency code and decimal value.
              - …
          - `sku` string
      - PhysicalProduct: A PHYSICAL product.
        - `createdOn` string, date-time, required
        - `description` string
        - `id` string, required
        - `images` ProductImage[]
          - `altText` string: Alt text for the image; impacts SEO and appears in search results.
          - `availableFormats` string[]: Available image sizes. Use with `images.url` and a `format` query parameter to retrieve the image at a particular width.
          - `id` string: Unique ProductImage id.
          - `orderIndex` integer: Position of the image in the product's image list.
          - `originalSize` object: Image size when first uploaded.
          - `url` string: Absolute URL of the image hosted on Squarespace.
        - `isVisible` boolean
        - `modifiedOn` string, date-time, required
        - `name` string
        - `seoOptions` SeoOptions: Options for search engine optimization.
          - `description` string
          - `title` string
        - `storePageId` string, required
        - `tags` string[]
        - `type` 'PHYSICAL' | 'SERVICE' | 'GIFT_CARD' | 'DIGITAL', required
        - `url` string
        - `urlSlug` string
        - `variantAttributes` string[]
        - `variants` PhysicalProductVariant[]
          - `attributes` object
          - `gtin` string
          - `id` string
          - `image` ProductImage: Product image assigned to the variant.
            - `altText` string: Alt text for the image; impacts SEO and appears in search results.
            - `availableFormats` string[]: Available image sizes. Use with `images.url` and a `format` query parameter to retrieve the image at a particular width.
            - `id` string: Unique ProductImage id.
            - `orderIndex` integer: Position of the image in the product's image list.
            - `originalSize` object: Image size when first uploaded.
            - `url` string: Absolute URL of the image hosted on Squarespace.
          - `mpn` string
          - `pricing` FullProductPricing
            - `basePrice` MonetaryAmount: A monetary amount with currency code and decimal value.
              - …
            - `onSale` boolean
            - `salePrice` MonetaryAmount: A monetary amount with currency code and decimal value.
              - …
          - `shippingMeasurements` ProductMeasurements: Measurements of the variant when it's shipped. Present for PHYSICAL products only.
            - `dimensions` ProductDimensions: Physical dimensions of the variant.
              - …
            - `weight` ProductWeight: Weight of the variant.
              - …
          - `sku` string
          - `stock` ProductStock: Available stock for the variant. Present for PHYSICAL products only.
            - `quantity` integer: Number of units that can be purchased.
            - `unlimited` boolean: Indicates whether the variant has unlimited stock.
      - ServiceProduct: A SERVICE product.
        - `createdOn` string, date-time, required
        - `description` string
        - `id` string, required
        - `images` ProductImage[]
          - `altText` string: Alt text for the image; impacts SEO and appears in search results.
          - `availableFormats` string[]: Available image sizes. Use with `images.url` and a `format` query parameter to retrieve the image at a particular width.
          - `id` string: Unique ProductImage id.
          - `orderIndex` integer: Position of the image in the product's image list.
          - `originalSize` object: Image size when first uploaded.
          - `url` string: Absolute URL of the image hosted on Squarespace.
        - `isVisible` boolean
        - `modifiedOn` string, date-time, required
        - `name` string
        - `seoOptions` SeoOptions: Options for search engine optimization.
          - `description` string
          - `title` string
        - `storePageId` string, required
        - `tags` string[]
        - `type` 'PHYSICAL' | 'SERVICE' | 'GIFT_CARD' | 'DIGITAL', required
        - `url` string
        - `urlSlug` string
        - `variantAttributes` string[]
        - `variants` ServiceProductVariant[]
          - `attributes` object
          - `id` string
          - `image` ProductImage: Product image assigned to the variant.
            - `altText` string: Alt text for the image; impacts SEO and appears in search results.
            - `availableFormats` string[]: Available image sizes. Use with `images.url` and a `format` query parameter to retrieve the image at a particular width.
            - `id` string: Unique ProductImage id.
            - `orderIndex` integer: Position of the image in the product's image list.
            - `originalSize` object: Image size when first uploaded.
            - `url` string: Absolute URL of the image hosted on Squarespace.
          - `pricing` FullProductPricing
            - `basePrice` MonetaryAmount: A monetary amount with currency code and decimal value.
              - …
            - `onSale` boolean
            - `salePrice` MonetaryAmount: A monetary amount with currency code and decimal value.
              - …
          - `sku` string
          - `stock` ProductStock: Available stock for the variant. Present for PHYSICAL products only.
            - `quantity` integer: Number of units that can be purchased.
            - `unlimited` boolean: Indicates whether the variant has unlimited stock.

## Other responses

- `400`: Bad request. The provided product IDs are invalid or exceed the maximum of 50.
- `404`: Not found. One or more requested Products were not found.

---

[API](https://skmtc.dev/squarespace/apis/commerce-api.md) - [All operations](https://skmtc.dev/squarespace/apis/commerce-api/llms.txt) - [OpenAPI document](https://skmtc.dev/squarespace/apis/commerce-api/revisions/5dd4b1b7cd38?raw)