Skip to main content
GET
List store products

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

state
object

Filter, sort, and paginate products with a URL-encoded JSON object:

Any other top-level property is rejected.

PaginationstartRow and endRow select which slice of results to return: startRow defaults to 0, and endRow defaults to startRow plus 10. You can request at most 1000 rows at a time (endRow - startRow <= 1000). The response's rowCount field always reflects the total number of matching rows across the entire result set, not just the rows returned in this request.

SortingsortModel orders results by any filterable field except the related-entity fields, plus id. If you don't specify a sortModel, results are sorted by created_at descending (newest first).

FilteringfilterModel is an object keyed by field name, where each value describes how to match that field:

type is optional for set and boolean filters and defaults to in. Boolean fields also accept set filters, and date fields also accept "filterType": "datetime". Set filters must be flat — compound AND/OR conditions are rejected.

include
enum<string>[]

Comma-separated list of related data to include on each product:

  • active_vendor — Populates active_vendor with the product's primary vendor.
  • active_vendor_product — Populates active_vendor_product with the primary vendor's catalog entry, including costs.
  • inventory — Populates inventory with on-hand quantity data.
  • store_vendor_products — Populates store_vendor_products with every vendor's catalog entry for the product.
Available options:
active_vendor,
active_vendor_product,
inventory,
store_vendor_products

Response

data
object[]
required

Products in the requested row window.

rowCount
integer
required

Total number of products matching the filters, across all row windows.