Skip to main content
GET
List Products
V2 Alpha — This endpoint is part of the V2 API preview. Breaking changes may occur.

Overview

Retrieve a paginated list of products belonging to the authenticated vendor. Results include product title, handle, status, variants, and images. Only products assigned to the vendor are returned.
Vendor Token Required — This endpoint requires a vendor-scoped JWT token. Merchant tokens will receive a 403 error.

Use Cases

  • Product catalogue — Display a vendor’s product listings in a custom portal
  • Inventory management — Pull product data for stock-level monitoring
  • Product sync — Export vendor products to external systems

Query Parameters

string
Filter by product status. One of: active, draft, archived.
string
Filter by creation date (minimum, ISO 8601). Example: 2024-01-01T00:00:00Z.
string
Filter by creation date (maximum, ISO 8601).
Search in product title or handle (max 200 characters).
integer
Number of items to return, forward pagination (1-100).
string
Cursor for forward pagination.
integer
Number of items to return, backward pagination (1-100).
string
Cursor for backward pagination.

Response

200

Example

More Examples

Filter active products sorted by inventory
Search out-of-stock products