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

1 {
2   "data": [
3     {
4       "variations": [
5         {
6           "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.",
7           "external_id": "light",
8           "name": "Light",
9           "uuid": "877427a0-731f-0136-9d2f-633ff0d6ced1"
10         },
11         {
12           "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.",
13           "external_id": "bold",
14           "name": "Bold",
15           "uuid": "87be3180-731f-0136-9d2f-633ff0d6ced1"
16         },
17         {
18           "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.",
19           "external_id": "warm",
20           "name": "Warm",
21           "uuid": "87d48e90-731f-0136-9d2f-633ff0d6ced1"
22         }
23       ],
24       "uuid": "872b3e20-731f-0136-9d2f-633ff0d6ced1",
25       "name": "Cornerstone-blog",
26       "is_private": true,
27       "is_active": false,
28       "updated_at": "2022-09-15T09:14:15Z"
29     },
30     {
31       "variations": [
32         {
33           "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.",
34           "external_id": "light",
35           "name": "Light",
36           "uuid": "b16c3fe0-7bcb-0136-b5fc-07fe54a9e639"
37         },
38         {
39           "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.",
40           "external_id": "bold",
41           "name": "Bold",
42           "uuid": "b17d57e0-7bcb-0136-b5fc-07fe54a9e639"
43         },
44         {
45           "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.",
46           "external_id": "warm",
47           "name": "Warm",
48           "uuid": "b18ad610-7bcb-0136-b5fc-07fe54a9e639"
49         }
50       ],
51       "uuid": "e3d82ce0-9bae-0133-0de7-525400970412",
52       "name": "Cornerstone",
53       "is_private": false,
54       "is_active": true,
55       "updated_at": "2022-09-15T09:14:15Z"
56     },
57     {
58       "variations": [
59         {
60           "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.",
61           "external_id": "minimal",
62           "name": "Minimal",
63           "uuid": "fec9fe60-7ede-0136-effe-0cbd49ed50aa"
64         },
65         {
66           "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.",
67           "external_id": "bright",
68           "name": "Bright",
69           "uuid": "fee26530-7ede-0136-effe-0cbd49ed50aa"
70         },
71         {
72           "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.",
73           "external_id": "contrast",
74           "name": "Contrast",
75           "uuid": "fef38820-7ede-0136-effe-0cbd49ed50aa"
76         },
77         {
78           "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.",
79           "external_id": "highlight",
80           "name": "Highlight",
81           "uuid": "ff085ab0-7ede-0136-effe-0cbd49ed50aa"
82         }
83       ],
84       "uuid": "1242c920-a5a6-0133-a20e-525400970412",
85       "name": "Fortune",
86       "is_private": false,
87       "is_active": false,
88       "updated_at": "2022-09-15T09:14:15Z"
89     }
90   ],
91   "meta": {}
92 }

Returns a list of store Themes.

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

{
  "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": {}
}

UI Name	Permission	Parameter
Themes	modify	`store_themes_manage`

UI Name

Permission

Parameter

Themes

modify

store_themes_manage

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

Header

Argument

Description

X-Auth-Token

access_token

For more about API accounts that generate access_tokens, see our Guide to API Accounts.

List Themes

List Themes

Authentication

OAuth scopes

Authentication header

Further reading

Path parameters

Headers

Response

Authentication

OAuth scopes

Authentication header

Further reading

Path parameters

Headers

Response

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

1	{
2	"data": [
3	{
4	"variations": [
5	{
6	"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.",
7	"external_id": "light",
8	"name": "Light",
9	"uuid": "877427a0-731f-0136-9d2f-633ff0d6ced1"
10	},
11	{
12	"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.",
13	"external_id": "bold",
14	"name": "Bold",
15	"uuid": "87be3180-731f-0136-9d2f-633ff0d6ced1"
16	},
17	{
18	"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.",
19	"external_id": "warm",
20	"name": "Warm",
21	"uuid": "87d48e90-731f-0136-9d2f-633ff0d6ced1"
22	}
23	],
24	"uuid": "872b3e20-731f-0136-9d2f-633ff0d6ced1",
25	"name": "Cornerstone-blog",
26	"is_private": true,
27	"is_active": false,
28	"updated_at": "2022-09-15T09:14:15Z"
29	},
30	{
31	"variations": [
32	{
33	"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.",
34	"external_id": "light",
35	"name": "Light",
36	"uuid": "b16c3fe0-7bcb-0136-b5fc-07fe54a9e639"
37	},
38	{
39	"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.",
40	"external_id": "bold",
41	"name": "Bold",
42	"uuid": "b17d57e0-7bcb-0136-b5fc-07fe54a9e639"
43	},
44	{
45	"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.",
46	"external_id": "warm",
47	"name": "Warm",
48	"uuid": "b18ad610-7bcb-0136-b5fc-07fe54a9e639"
49	}
50	],
51	"uuid": "e3d82ce0-9bae-0133-0de7-525400970412",
52	"name": "Cornerstone",
53	"is_private": false,
54	"is_active": true,
55	"updated_at": "2022-09-15T09:14:15Z"
56	},
57	{
58	"variations": [
59	{
60	"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.",
61	"external_id": "minimal",
62	"name": "Minimal",
63	"uuid": "fec9fe60-7ede-0136-effe-0cbd49ed50aa"
64	},
65	{
66	"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.",
67	"external_id": "bright",
68	"name": "Bright",
69	"uuid": "fee26530-7ede-0136-effe-0cbd49ed50aa"
70	},
71	{
72	"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.",
73	"external_id": "contrast",
74	"name": "Contrast",
75	"uuid": "fef38820-7ede-0136-effe-0cbd49ed50aa"
76	},
77	{
78	"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.",
79	"external_id": "highlight",
80	"name": "Highlight",
81	"uuid": "ff085ab0-7ede-0136-effe-0cbd49ed50aa"
82	}
83	],
84	"uuid": "1242c920-a5a6-0133-a20e-525400970412",
85	"name": "Fortune",
86	"is_private": false,
87	"is_active": false,
88	"updated_at": "2022-09-15T09:14:15Z"
89	}
90	],
91	"meta": {}
92	}