• Version: 3.0
  • Host:
  • Protocols: https
  • Accepts: application/json
  • Responds With: application/json

Create and manage product listings for multiple storefronts and sales channels.

Deprecation notice:
As of April 2020, the new status property should be used instead of the is_enabled property. The is_enabled property will be deprecated.

The status property should be used as follows based on channel type and platform:

Type Platform Status
storefront bigcommerce active, inactive, archived
storefront Is not bigcommerce active, inactive, disconnected
marketing, marketplace, pos N/A connected, disconnected

OAuth Scopes

UI Name Permission Parameter
Channel Listings modify store_channel_listings
Channel Listings read-only store_channel_listings_read_only
Channel Settings modify store_channel_settings
Channel Settings read-only store_channel_settings_read_only

For more information on OAuth Scopes, see: Authentication.


Requests can be authenticated by sending a client_id and access_token via X-Auth-Client and X-Auth-Token HTTP headers:

GET /stores/store_hash/v3/catalog/summary
Accept: application/json
X-Auth-Client: {client_id}
X-Auth-Token: {access_token}
Header Parameter Description
X-Auth-Client client_id Obtained by creating an API account or installing an app in a BigCommerce control panel.
X-Auth-Token access_token Obtained by creating an API account or installing an app in a BigCommerce control panel.

For more information on Authenticating BigCommerce APIs, see: Authentication.

Available Endpoints

Resource / Endpoint Description
Channels Create and manage catalog listings and channels
Channel Site Manage sites and routing for headless storefronts
Channel Listings Manage catalog differences among different storefronts or marketplaces

Usage Notes

Channels and Channel Listings:

  • A channel is anywhere a merchant sells their products. This encompasses headless storefronts, marketplaces, POS systems, and marketing platforms.
  • Channel listings allow you to manage catalog differences among different storefronts or marketplaces.

Sites and Site Routes:

  • Sites and routes control the paths that make up a headless storefront
  • Site refers to the domain associated with a channel
  • Routes point to the URLs for key pages on the headless storefront. They define where your homepage is, where your cart page is, etc.
  • Sites and routes ensure links point where they’re supposed to and sales are attributed correctly. For example, a shopper’s order confirmation email should link back to Storefront A, where they placed their order, not Storefront B, which they’ve never visited.


Related Endpoints