List Themes

GET

https://api.bigcommerce.com/stores/:store_hash/v3/themes

GET

/stores/:store_hash/v3/themes

curl https://api.bigcommerce.com/stores/store_hash/v3/themes \
     -H "Accept: application/json" \
     -H "X-Auth-Token: <apiKey>"

200response

{
  "data": [
    {
      "variations": [
        {
          "description": "Ideal for a wide range of businesses and brands, this design is fully responsive, simple, and ready for you to add your branding, logo, and products. It comes ready to build a clean looking and beautiful store with features such as homepage carousel, social media icons, featured and top selling products, and faceted search (which is available on select BigCommerce plans). Fully express your brand by using our Theme Editor to quickly and easily style your site’s fonts and colors, all without the need to write code.",
          "external_id": "light",
          "name": "Light",
          "uuid": "877427a0-731f-0136-9d2f-633ff0d6ced1"
        },
        {
          "description": "Ideal for a wide range of businesses and brands, this design is fully responsive, simple, and ready for you to add your branding, logo, and products. It comes ready to build a clean looking and beautiful store with features such as homepage carousel, social media icons, featured and top selling products, and faceted search (which is available on select BigCommerce plans). Fully express your brand by using our Theme Editor to quickly and easily style your site’s fonts and colors, all without the need to write code.",
          "external_id": "bold",
          "name": "Bold",
          "uuid": "87be3180-731f-0136-9d2f-633ff0d6ced1"
        },
        {
          "description": "Ideal for a wide range of businesses and brands, this design is fully responsive, simple, and ready for you to add your branding, logo, and products. It comes ready to build a clean looking and beautiful store with features such as homepage carousel, social media icons, featured and top selling products, and faceted search (which is available on select BigCommerce plans). Fully express your brand by using our Theme Editor to quickly and easily style your site’s fonts and colors, all without the need to write code.",
          "external_id": "warm",
          "name": "Warm",
          "uuid": "87d48e90-731f-0136-9d2f-633ff0d6ced1"
        }
      ],
      "uuid": "872b3e20-731f-0136-9d2f-633ff0d6ced1",
      "name": "Cornerstone-blog",
      "is_private": true,
      "is_active": false,
      "updated_at": "2022-09-15T09:14:15Z"
    },
    {
      "variations": [
        {
          "description": "Ideal for a wide range of businesses and brands, this design is fully responsive, simple, and ready for you to add your branding, logo, and products. It comes ready to build a clean looking and beautiful store with features such as homepage carousel, social media icons, featured and top selling products, and faceted search (which is available on select BigCommerce plans). Fully express your brand by using our Theme Editor to quickly and easily style your site’s fonts and colors, all without the need to write code.",
          "external_id": "light",
          "name": "Light",
          "uuid": "b16c3fe0-7bcb-0136-b5fc-07fe54a9e639"
        },
        {
          "description": "Ideal for a wide range of businesses and brands, this design is fully responsive, simple, and ready for you to add your branding, logo, and products. It comes ready to build a clean looking and beautiful store with features such as homepage carousel, social media icons, featured and top selling products, and faceted search (which is available on select BigCommerce plans). Fully express your brand by using our Theme Editor to quickly and easily style your site’s fonts and colors, all without the need to write code.",
          "external_id": "bold",
          "name": "Bold",
          "uuid": "b17d57e0-7bcb-0136-b5fc-07fe54a9e639"
        },
        {
          "description": "Ideal for a wide range of businesses and brands, this design is fully responsive, simple, and ready for you to add your branding, logo, and products. It comes ready to build a clean looking and beautiful store with features such as homepage carousel, social media icons, featured and top selling products, and faceted search (which is available on select BigCommerce plans). Fully express your brand by using our Theme Editor to quickly and easily style your site’s fonts and colors, all without the need to write code.",
          "external_id": "warm",
          "name": "Warm",
          "uuid": "b18ad610-7bcb-0136-b5fc-07fe54a9e639"
        }
      ],
      "uuid": "e3d82ce0-9bae-0133-0de7-525400970412",
      "name": "Cornerstone",
      "is_private": false,
      "is_active": true,
      "updated_at": "2022-09-15T09:14:15Z"
    },
    {
      "variations": [
        {
          "description": "Fortune is a standout theme for cutting-edge online stores. Customers will be transfixed by its striking hero area, which puts your imagery on full display, along with its sleek navigation and unique product grid. Ideal for small-to-medium-sized catalogs, Fortune has everything you need to command and convert shoppers.",
          "external_id": "minimal",
          "name": "Minimal",
          "uuid": "fec9fe60-7ede-0136-effe-0cbd49ed50aa"
        },
        {
          "description": "Fortune is a standout theme for cutting-edge online stores. Customers will be transfixed by its striking hero area, which puts your imagery on full display, along with its sleek navigation and unique product grid. Ideal for small-to-medium-sized catalogs, Fortune has everything you need to command and convert shoppers.",
          "external_id": "bright",
          "name": "Bright",
          "uuid": "fee26530-7ede-0136-effe-0cbd49ed50aa"
        },
        {
          "description": "Fortune is a standout theme for cutting-edge online stores. Customers will be transfixed by its striking hero area, which puts your imagery on full display, along with its sleek navigation and unique product grid. Ideal for small-to-medium-sized catalogs, Fortune has everything you need to command and convert shoppers.",
          "external_id": "contrast",
          "name": "Contrast",
          "uuid": "fef38820-7ede-0136-effe-0cbd49ed50aa"
        },
        {
          "description": "Fortune is a standout theme for cutting-edge online stores. Customers will be transfixed by its striking hero area, which puts your imagery on full display, along with its sleek navigation and unique product grid. Ideal for small-to-medium-sized catalogs, Fortune has everything you need to command and convert shoppers.",
          "external_id": "highlight",
          "name": "Highlight",
          "uuid": "ff085ab0-7ede-0136-effe-0cbd49ed50aa"
        }
      ],
      "uuid": "1242c920-a5a6-0133-a20e-525400970412",
      "name": "Fortune",
      "is_private": false,
      "is_active": false,
      "updated_at": "2022-09-15T09:14:15Z"
    }
  ],
  "meta": {}
}

Returns a list of store Themes.

Authentication

X-Auth-Tokenstring

OAuth scopes

UI Name	Permission	Parameter
Themes	modify	`store_themes_manage`

Authentication header

Header	Argument	Description
`X-Auth-Token`	`access_token`	For more about API accounts that generate `access_token`s, see our Guide to API Accounts.

Path parameters

store_hashstringRequired

Permanent ID of the BigCommerce store.

Response

datalist of objectsOptional

metaobjectOptional

Response metadata.