Skip to main content
GET
List Collections

List Collections

Returns a paginated list of collections in the store, in Shopify-compatible shape.

Request

Parameters

page
integer
default:"1"
Page number for pagination
limit
integer
default:"50"
Number of items per page
title
string
Filter by collection title (partial, case-insensitive match)
handle
string
Filter by exact handle

Response

Returns a bare Shopify-style object with the collections under the collections array. Pagination is conveyed via a page-based Link response header (rel="next" / rel="previous"), not in the body.
collections
array
Array of collection objects

Example Response

Pagination header:

Errors

Failures return a Shopify-style { errors } body with the appropriate HTTP status:
StatusDescription
401Invalid or missing access token
403App doesn’t have the read_products scope