---
title: "List products"
method: GET
path: "/v1/accounts/{accountId}/products"
tags: ["Products"]
---

# List products

`GET /v1/accounts/{accountId}/products`

Lists the products on the connected store in the platform's default
order, each with its variants, options and images. Cursor-paginated:
pass `limit` (1-50, default 20) and the `cursor` from a previous
response's `nextCursor`; `nextCursor` is null when there are no more
pages. Filter with `status` and/or `query` (the platform's product
search syntax, e.g. `title:*shirt* vendor:Acme tag:summer`).

Supported on Shopify (platform `shopify`); accounts on other
platforms return 400. A store connected before product access was
added answers 403 insufficient_permissions until the merchant
reconnects it through `GET /v1/connect/shopify`.

## Path parameters

- `accountId` string, required

## Query parameters

- `limit` integer
- `cursor` string
- `status` 'active' | 'draft' | 'archived'
- `query` string

## Response `200`

Products listed

- object
  - `platform` 'shopify'
  - `products` Product[]
    - `id` string — Platform-native product id (numeric string for Shopify).
    - `platform` 'shopify'
    - `title` string
    - `handle` string — URL slug of the product.
    - `descriptionHtml` string, nullable — Product description as HTML.
    - `vendor` string, nullable
    - `productType` string, nullable — Free-text product type as set on the store.
    - `tags` string[]
    - `status` 'active' | 'draft' | 'archived'
    - `featuredImage` ProductImage
      - `url` string
      - `altText` string, nullable
    - `images` ProductImage[] — First 20 images in the product media, in store order.
      - `url` string
      - `altText` string, nullable
    - `options` object[] — Option axes (e.g. Size, Color) and their values.
      - `name` string
      - `values` string[]
    - `variants` ProductVariant[] — First 100 variants.
      - `id` string — Platform-native variant id (numeric string for Shopify).
      - `title` string — Option combination label, e.g. "S / Blue".
      - `sku` string, nullable
      - `barcode` string, nullable
      - `price` string — Decimal amount in the store currency, e.g. "19.90".
      - `compareAtPrice` string, nullable — Strike-through price; null when the variant is not on sale.
      - `inventoryQuantity` integer, nullable — Units on hand across locations; null when inventory is not tracked.
      - `availableForSale` boolean
      - `selectedOptions` object[]
        - `name` string
        - `value` string
    - `seo` object
      - `title` string, nullable
      - `description` string, nullable
    - `totalInventory` integer, nullable
    - `onlineStoreUrl` string, nullable — Public storefront URL; null while the product is not published to the online store.
    - `createdAt` string, date-time, nullable
    - `updatedAt` string, date-time, nullable
    - `publishedAt` string, date-time, nullable
  - `nextCursor` string, nullable — Cursor for the next page; null when there are no more pages.

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `403` — The platform rejected the request (code insufficient_permissions). The store lacks the product scopes or the token was revoked; reconnect the Shopify account.
- `404` — Account not found or not accessible (code account_not_found).
- `429` — Rate limited, either by Zernio or by Shopify. Retry later.

## Changes

- **2026-09-25** `2c04683ce694` — 4 info
  - added the optional property `details/adAccountId` to the response with the `400` status
  - added the optional property `details/createdObjects` to the response with the `400` status
  - added the optional property `details/stage` to the response with the `400` status
  - added the optional property `details/unconfirmedWrite` to the response with the `400` status
- **2026-09-17** `be448f13ecdc` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/accounts/:accountId/products/get.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) · [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/b2325332041a?raw)