GET
/v1/productsList all products
Lists products sorted by creation date, with the most recently created products first. Use active, shippable, url, ids, or a creation-time filter to narrow the results, and use cursor parameters to paginate through the list.
- RetriesRetries up to 2×, 500ms backoff, 30s timeout.
activebooleanoptional
Filters products by active state; pass false to list inactive products.
createdobjectoptional
Filters products by creation time using a Unix timestamp or a range with `gt`, `gte`, `lt`, or `lte`.
ending_beforestringoptional
An object ID cursor that fetches the page before the specified product.
expandarray<string>optional
Specifies response fields to expand.
idsarray<string>optional
Filters by product IDs. Do not use this parameter with `starting_after` or `ending_before`.
limitintegeroptional
The number of products to return. Must be between 1 and 100 and defaults to 10 when omitted.
shippablebooleanoptional
Filters for products that can be shipped, such as physical rather than digital products.
starting_afterstringoptional
An object ID cursor that fetches the page after the specified product.
urlstringoptional
Filters products by the specified URL.
200Returns a product list containing product objects sorted by creation date, a `has_more` pagination flag, the list object type, and the list URL.
dataarray<Product>required
Details about each object.
has_morebooleanrequired
True if this list has another page of items after this one that can be fetched.
objectstringrequired
String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
urlstringrequired
The URL where this list can be accessed.
defaultReturns an error object containing an error type and details about the failed request.
errorobjectrequired
Error handling
limit must be between 1 and 100 and defaults to 10 when omitted. Do not combine ids with starting_after or ending_before. Use starting_after or ending_before with an object ID to navigate through the results.