Access to individual endpoints can be restricted per account. If a request to this endpoint returns
403 with error code endpoint_not_enabled and you expect to have access, contact your account representative.GET /v1/products/lists to retrieve all product lists associated with your API key. You can optionally filter the results by one or more metadata key:value pairs. The response includes list summaries — name, products_count, and metadata — but not the individual product details.
This endpoint returns list summaries only. It does not return the products inside each list. To retrieve full product data for a specific list, use GET /v1/products/lists/.
Request
Endpoint:GET /v1/products/lists
Headers
Query parameters
Filter lists by a metadata key:value pair. Repeat for multiple filters. Only lists that match all specified pairs are returned.
Example requests
Response
A200 OK response contains a paginated data array of list summary objects and a meta object with pagination details.