List Collections

List Collections

Log in to see full request history
timestatususer agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required
Query Params
string

ID of item after which the collection should be returned. More examples and info about pagination in our guides.

string

Sort order of a list response. Use 'desc' to reverse the default 'asc' (ascending) sort order. Examples in our guides.

string

Sort property of a list response. The default is id and thus the created_at order.
If you sort by other properties, we additionally sort by id implicitly as a secondary sort property, so that you can rely on the sort order to be deterministic even if the main sort property ends up with the same values.

filter
object

Filter by available properties in query params, like this: api/v2/resources?filter[id]=value&filter[another_property]=value1,value2. Check our Filtering guide for examples and all about filtering here.

Responses

Response body
array of objects
object
integer
required

Numeric ID of the collection

string | null

Public ID is a string version of the numeric ID

integer
required

ID reference to the workspace to which the collection belongs

string
required

Name of the products collection

string | null

Description of the collection

string | null

Type of the collection (manual or automatic)

array | null

Array of product IDs in the collection. Updating with invalid or non-workspace product IDs will result in an error. If IDs from existing products in the collection are left out, they will be removed from the collection. You can also remove all the products from a collection by providing an empty array.

product_ids
string | null

Method used to sort the products in the collection

manually name_asc name_desc price_desc price_asc added_at_desc added_at_asc created_at_desc created_at_asc

boolean | null

Whether the collection is archived

string | null

Collection image

boolean | null

Whether the collection is visible in the online store

string | null

Current path of the collection

string | null

Title of the collection for SEO purposes

string | null

Description of the collection for SEO purposes

string | null

Whether the collection is indexable by search engines

string | null

Image for social sharing

string | null

Date and time the collection was created

string | null

Date and time the collection was last updated

Headers
object
string

ID of the last item in the current response after which more records exist. You can use it in an after query parameter for cursor-based pagination to get to the next page.

string

Language
Credentials
URL