Skip to content

List all collections without pagination

GET
/stores/{storeRef}/collections/all
curl --request GET \
--url 'https://apibase.ecomweb.app/api/v1/stores/example/collections/all?ids=1%2C2%2C3&type=manual&status=draft&search=summer&name=Summer%20Collection&slug=summer-collection&sort_by=name&sort_order=asc&limit=10&offset=0&include_product_count=false&include_seo_metadata=false' \
--header 'x-api-key: <x-api-key>'

Returns every collection with the status you ask for (active by default) in one unpaginated array, with product counts and SEO fields included unless you turn them off. Intended for export and sync jobs; for browsing use the paginated list. limit and offset have no effect.

Required scopes: read:categories

storeRef
required
string

The store’s ref, as returned by GET /stores.

ids
string

Example

1,2,3

Filter by specific collection IDs (comma-separated)

type
string
Allowed values: manual smart

Filter by collection type

status
string
Allowed values: draft active archived unlisted

Filter by collection status

search
string

Example

summer

Search collections by name or description

name
string

Example

Summer Collection

Filter by collection name

slug
string

Example

summer-collection

Filter by slug

sort_by
string

Example

name

Sort field

sort_order
string
default: asc
Allowed values: asc desc

Sort order

limit
number
default: 10 >= 1

Example

10

Number of items per page

offset
number
0

Example

0

Number of items to skip

include_product_count
boolean

Example

true

Include product count in the response for each collection

include_seo_metadata
boolean

Example

true

Include SEO metadata in the response

Media typeapplication/json
Array<object>
object
type
required

manual collections list products you choose; smart collections select products with search_criteria.

string
Allowed values: manual smart
status
required

Publication status.

string
Allowed values: draft active archived unlisted
search_criteria
required

The rules a smart collection selects products with, or null for a manual collection.

object
key
additional properties
any
facet_config
required

The facets shoppers can filter the collection by, computed by the store, or null when not yet computed.

object
key
additional properties
any
collection_sort
required

How products are ordered within the collection.

string
Allowed values: manual product_name_asc product_name_desc best_selling highest_price lowest_price newest oldest
product_ids

Product IDs of a manual collection, in display order. Not present on smart collections.

Array<number>
seo_metadata

SEO fields. Present only when include_seo_metadata is true.

object
meta_title
required

Page title for search engines, or null.

string
nullable
meta_description
required

Page description for search engines, or null.

string
nullable
id
required

Collection ID.

number
name
required

Collection name.

string
description
required

Collection description, or null.

string
nullable
image_url
required

URL of the collection image, or null.

string
nullable
slug
required

URL-friendly identifier, unique within the store.

string
generated_from_category_id
required

ID of the category this collection was generated from, or null for a collection created by hand.

number
nullable
created_at
required

When the collection was created, as an ISO 8601 timestamp.

string
updated_at
required

When the collection was last updated, as an ISO 8601 timestamp.

string
deleted_at
required

Always null; deleted collections are not returned.

string
nullable
product_count

Number of products in the collection. Present only when include_product_count is true.

number

Example

[
{
"type": "manual",
"status": "draft",
"collection_sort": "manual"
}
]

The request is malformed or failed validation.

Media typeapplication/json
One of:
object
statusCode
required

The HTTP status code.

number
message
required

What went wrong; validation failures list one message per problem.

One of:
string
error

The HTTP status text, such as Bad Request.

string

Example generated

{
"statusCode": 1,
"message": [
"example"
],
"error": "example"
}

The key is missing, invalid, revoked or expired.

Media typeapplication/json
One of:
object
statusCode
required

The HTTP status code.

number
message
required

What went wrong; validation failures list one message per problem.

One of:
string
error

The HTTP status text, such as Bad Request.

string

Example generated

{
"statusCode": 1,
"message": [
"example"
],
"error": "example"
}

The key may not do this: a missing scope, a readonly key, a publishable key on a Store API route, or a disallowed origin.

Media typeapplication/json
One of:
object
statusCode
required

The HTTP status code.

number
message
required

What went wrong; validation failures list one message per problem.

One of:
string
error

The HTTP status text, such as Bad Request.

string

Example generated

{
"statusCode": 1,
"message": [
"example"
],
"error": "example"
}