Collections API reference

Reference map for Collections API operations.

Updated
Apr 26, 2026

Collections

Use the section that matches your caller: storefront clients use Shopper REST or Search, trusted services use Management, and signed-in customer flows use Auth. Prefer Search API for new discovery-heavy storefront work.

Use Collections when the job is about curated product groupings and collection hierarchy, not taxonomy-wide category navigation.

Management API collection operations own collection records, nested collection trees, product membership, and bulk collection or membership changes. Shopper API collection routes are read-only compatibility routes for storefront collection reads; prefer Search for new discovery-heavy storefront work.

Use collection-product operations when a product is being added to or removed from a curated collection. Use Products when the product record itself is changing.

For workflow guidance across taxonomy, curated merchandising groups, reusable labels, brand/series records, templates, and storefront discovery reads, see Catalog organization and discovery.

Shopper API · read

Read and inspect

Management API · read, create, update, remove, and bulk operations

Read and inspect

OperationAPI
Get a collection by IDManagement API
Get collection treeManagement API
List all collectionsManagement API
List products in a collectionManagement API

Create or attach

OperationAPI
Add products to collectionManagement API
Create a new collectionManagement API

Update or repair

OperationAPI
Update a collectionManagement API

Remove or deactivate

OperationAPI
Delete a collectionManagement API
Remove products from collectionManagement API

Bulk operations

Collections API reference

# Collections Use the section that matches your caller: storefront clients use Shopper REST or Search, trusted services use Management, and signed-in customer flows use Auth. Prefer Search API for new discovery-heavy storefront work. Use Collections when the job is about curated product groupings and collection hierarchy, not taxonomy-wide category navigation. Management API collection operations own collection records, nested collection trees, product membership, and bulk collection or membership changes. Shopper API collection routes are read-only compatibility routes for storefront collection reads; prefer Search for new discovery-heavy storefront work. Use collection-product operations when a product is being added to or removed from a curated collection. Use Products when the product record itself is changing. For workflow guidance across taxonomy, curated merchandising groups, reusable labels, brand/series records, templates, and storefront discovery reads, see [Catalog organization and discovery](/start/concepts/catalog-organization-and-discovery).

17 operations grouped by API, then by the job they support.

## Shopper API · read ### Read and inspect | Operation | API | | --- | --- | | [Fetch a collection by URI](/reference/collections/fetch-a-collection-by-uri) | Shopper API | | [Fetch all collection slugs](/reference/collections/fetch-all-collection-slugs) | Shopper API | | [Fetch all collections](/reference/collections/fetch-all-collections) | Shopper API | ## Management API · read, create, update, remove, and bulk operations ### Read and inspect | Operation | API | | --- | --- | | [Get a collection by ID](/reference/collections/get-a-collection-by-id) | Management API | | [Get collection tree](/reference/collections/get-collection-tree) | Management API | | [List all collections](/reference/collections/list-all-collections) | Management API | | [List products in a collection](/reference/collections/list-products-in-a-collection) | Management API | ### Create or attach | Operation | API | | --- | --- | | [Add products to collection](/reference/collections/add-products-to-collection) | Management API | | [Create a new collection](/reference/collections/create-a-new-collection) | Management API | ### Update or repair | Operation | API | | --- | --- | | [Update a collection](/reference/collections/update-a-collection) | Management API | ### Remove or deactivate | Operation | API | | --- | --- | | [Delete a collection](/reference/collections/delete-a-collection) | Management API | | [Remove products from collection](/reference/collections/remove-products-from-collection) | Management API | ### Bulk operations | Operation | API | | --- | --- | | [Bulk add products to collections](/reference/collections/bulk-add-products-to-collections) | Management API | | [Bulk create collections](/reference/collections/bulk-create-collections) | Management API | | [Bulk delete collections](/reference/collections/bulk-delete-collections) | Management API | | [Bulk remove products from collections](/reference/collections/bulk-remove-products-from-collections) | Management API | | [Bulk update collections](/reference/collections/bulk-update-collections) | Management API |