List Seller Products

GET

admin

sellers

{id}

products

curl 'http://localhost:9000/admin/sellers/sel_01HXYZABCDEF/products?limit=20' \
  -H 'Authorization: Bearer <token>'

const { products, count } = await client.admin.sellers.$id.products.query({
  $id: "sel_01HXYZABCDEF",
  limit: 20,
})

{
  "products": [
    {
      "id": "prod_01HXYZPRODAA",
      "title": "Canvas Tote Bag",
      "handle": "canvas-tote-bag",
      "status": "published",
      "thumbnail": "https://cdn.example.com/tote.jpg",
      "collection": null,
      "sales_channels": [],
      "variants": [{ "id": "variant_01HXYZVARAA" }],
      "created_at": "2026-06-03T10:00:00.000Z",
      "updated_at": "2026-06-03T10:00:00.000Z"
    }
  ],
  "count": 1,
  "offset": 0,
  "limit": 20
}

Returns the products owned by the seller.

Path parameters

string

required

The seller’s ID.

Query parameters

number

default:"50"

Maximum number of records to return.

number

default:"0"

Number of records to skip.

string

Field to sort by, prefix with - for descending order.

string

Comma-separated list of fields to include, prefix with +/- to add or remove from defaults.

string

Search term matched against product fields.

string | string[]

Filter by product ID(s).

string | string[]

Filter by product status.

string | string[]

Filter by collection ID(s).

string | string[]

Filter by sales channel ID(s).

string | string[]

Filter by product type ID(s).

string | string[]

Filter by product tag ID(s).

object

Filter by creation date with operators like $gte, $lte.

object

Filter by update date with operators like $gte, $lte.

Response

object[]

Show properties

string

The product’s ID.

string

Product title.

string

Unique URL-safe handle.

string

Product status, e.g. draft or published.

string

URL of the product’s thumbnail.

object

The product’s collection.

object[]

Sales channels the product is available in.

object[]

The product’s variants (IDs only by default).

string

Creation timestamp.

string

Last update timestamp.

number

Total number of the seller’s products.

number

Number of records skipped.

number

Number of records returned.

curl 'http://localhost:9000/admin/sellers/sel_01HXYZABCDEF/products?limit=20' \
  -H 'Authorization: Bearer <token>'

const { products, count } = await client.admin.sellers.$id.products.query({
  $id: "sel_01HXYZABCDEF",
  limit: 20,
})

{
  "products": [
    {
      "id": "prod_01HXYZPRODAA",
      "title": "Canvas Tote Bag",
      "handle": "canvas-tote-bag",
      "status": "published",
      "thumbnail": "https://cdn.example.com/tote.jpg",
      "collection": null,
      "sales_channels": [],
      "variants": [{ "id": "variant_01HXYZVARAA" }],
      "created_at": "2026-06-03T10:00:00.000Z",
      "updated_at": "2026-06-03T10:00:00.000Z"
    }
  ],
  "count": 1,
  "offset": 0,
  "limit": 20
}

curl 'http://localhost:9000/admin/sellers/sel_01HXYZABCDEF/products?limit=20' \
  -H 'Authorization: Bearer <token>'

const { products, count } = await client.admin.sellers.$id.products.query({
  $id: "sel_01HXYZABCDEF",
  limit: 20,
})

{
  "products": [
    {
      "id": "prod_01HXYZPRODAA",
      "title": "Canvas Tote Bag",
      "handle": "canvas-tote-bag",
      "status": "published",
      "thumbnail": "https://cdn.example.com/tote.jpg",
      "collection": null,
      "sales_channels": [],
      "variants": [{ "id": "variant_01HXYZVARAA" }],
      "created_at": "2026-06-03T10:00:00.000Z",
      "updated_at": "2026-06-03T10:00:00.000Z"
    }
  ],
  "count": 1,
  "offset": 0,
  "limit": 20
}

Overview

Panel extensions

Admin API

Vendor API

Store API

Configuration

Path parameters

Query parameters

Response

​Path parameters

​Query parameters

​Response

Path parameters

Query parameters

Response