Brands API reference

Reference map for Brands API operations.

Updated: Apr 26, 2026

Brands

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 Brands when the job is about brand records and brand-owned series, including brand/series media and storefront grouping.

Management API brand operations own trusted brand and series creation, updates, deletion, and listing. Shopper API brand routes are read-only compatibility routes for storefront reads; prefer Search for new discovery-heavy storefront work.

Use series operations only when the record belongs under a specific brand. Use Products when product-brand assignment or product details are the thing being changed.

For workflow guidance across brands, series, categories, collections, tags, templates, and storefront discovery reads, see Catalog organization and discovery.

Shopper API · read

Read and inspect

Operation	API
Fetch a brand	Shopper API
Fetch a brand by slug	Shopper API
Fetch all brands	Shopper API

Management API · read, create, update, and remove

Read and inspect

Operation	API
List all brands	Management API
List all series for a brand	Management API
Retrieve a brand by ID	Management API
Retrieve a series by ID	Management API

Create or attach

Operation	API
Create a new brand	Management API
Create a new series under a brand	Management API

Update or repair

Operation	API
Update an existing brand	Management API
Update an existing series	Management API

Remove or deactivate

Operation	API
Delete a brand	Management API
Delete a series	Management API

Brands API reference

# Brands 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 Brands when the job is about brand records and brand-owned series, including brand/series media and storefront grouping. Management API brand operations own trusted brand and series creation, updates, deletion, and listing. Shopper API brand routes are read-only compatibility routes for storefront reads; prefer Search for new discovery-heavy storefront work. Use series operations only when the record belongs under a specific brand. Use Products when product-brand assignment or product details are the thing being changed. For workflow guidance across brands, series, categories, collections, tags, templates, and storefront discovery reads, see [Catalog organization and discovery](/start/concepts/catalog-organization-and-discovery).

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

## Shopper API · read ### Read and inspect | Operation | API | | --- | --- | | [Fetch a brand](/reference/brands/fetch-a-brand) | Shopper API | | [Fetch a brand by slug](/reference/brands/fetch-a-brand-by-slug) | Shopper API | | [Fetch all brands](/reference/brands/fetch-all-brands) | Shopper API | ## Management API · read, create, update, and remove ### Read and inspect | Operation | API | | --- | --- | | [List all brands](/reference/brands/list-all-brands) | Management API | | [List all series for a brand](/reference/brands/list-all-series-for-a-brand) | Management API | | [Retrieve a brand by ID](/reference/brands/retrieve-a-brand-by-id) | Management API | | [Retrieve a series by ID](/reference/brands/retrieve-a-series-by-id) | Management API | ### Create or attach | Operation | API | | --- | --- | | [Create a new brand](/reference/brands/create-a-new-brand) | Management API | | [Create a new series under a brand](/reference/brands/create-a-new-series-under-a-brand) | Management API | ### Update or repair | Operation | API | | --- | --- | | [Update an existing brand](/reference/brands/update-an-existing-brand) | Management API | | [Update an existing series](/reference/brands/update-an-existing-series) | Management API | ### Remove or deactivate | Operation | API | | --- | --- | | [Delete a brand](/reference/brands/delete-a-brand) | Management API | | [Delete a series](/reference/brands/delete-a-series) | Management API |