> This page is for Developer.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

# List Themes

GET https://api.bigcommerce.com/stores/{store_hash}/v3/themes

Returns a list of store *Themes*.

Reference: https://docs.bigcommerce.com/developer/api-reference/rest/admin/content/themes/get-store-themes

## Authentication

- `X-Auth-Token` header (required) — ### 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](/developer/docs/overview/api-fundamentals/api-accounts#api-accounts). | ### Further reading For example requests and more information about authenticating BigCommerce APIs, see [Authentication and Example Requests](/developer/docs/overview/api-fundamentals/api-accounts#x-auth-token-header-example-requests). For more about BigCommerce OAuth scopes, see our [Guide to API Accounts](/developer/docs/overview/api-fundamentals/api-accounts#oauth-scopes). For a list of API status codes, see [API Status Codes](/developer/api-reference/rest/overview#rest-http-status-codes).

## Request

### Path parameters

- `store_hash` (string, required) — Permanent ID of the BigCommerce store.

### Headers

- `Accept` (string, required, default: application/json) — The [MIME type](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types) of the response body.

## Response

### 200

OK

- `data` (list of ThemesCollectionResponseDataItems, optional)
- `meta` (ThemesCollectionResponseMeta, optional) — Response metadata.

## Types

### ThemesCollectionResponseDataItems

A theme.

- `variations` (list of ThemesCollectionResponseDataItemsVariationsItems, optional) — The variations.
- `uuid` (string, optional) — The identifier.
- `name` (string, optional) — The theme name identifier.
- `is_private` (boolean, optional) — Flag to identify private themes.
- `is_active` (boolean, optional) — Indicates whether this theme is active on the storefront.
- `updated_at` (string, optional) — The date-time of the last theme update.

### ThemesCollectionResponseMeta

Response metadata.

### ThemesCollectionResponseDataItemsVariationsItems

A variation.

- `description` (string, optional) — The description.
- `external_id` (string, optional) — The external identifier.
- `name` (string, optional) — The name.
- `uuid` (string, optional) — The identifier.

## Examples

**Response**

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

**SDK Code**

```python response
import requests

url = "https://api.bigcommerce.com/stores/store_hash/v3/themes"

headers = {
    "Accept": "application/json",
    "X-Auth-Token": "<apiKey>"
}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript response
const url = 'https://api.bigcommerce.com/stores/store_hash/v3/themes';
const options = {
  method: 'GET',
  headers: {Accept: 'application/json', 'X-Auth-Token': '<apiKey>'}
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go response
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.bigcommerce.com/stores/store_hash/v3/themes"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Accept", "application/json")
	req.Header.Add("X-Auth-Token", "<apiKey>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby response
require 'uri'
require 'net/http'

url = URI("https://api.bigcommerce.com/stores/store_hash/v3/themes")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Accept"] = 'application/json'
request["X-Auth-Token"] = '<apiKey>'

response = http.request(request)
puts response.read_body
```

```java response
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.bigcommerce.com/stores/store_hash/v3/themes")
  .header("Accept", "application/json")
  .header("X-Auth-Token", "<apiKey>")
  .asString();
```

```php response
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.bigcommerce.com/stores/store_hash/v3/themes', [
  'headers' => [
    'Accept' => 'application/json',
    'X-Auth-Token' => '<apiKey>',
  ],
]);

echo $response->getBody();
```

```csharp response
using RestSharp;

var client = new RestClient("https://api.bigcommerce.com/stores/store_hash/v3/themes");
var request = new RestRequest(Method.GET);
request.AddHeader("Accept", "application/json");
request.AddHeader("X-Auth-Token", "<apiKey>");
IRestResponse response = client.Execute(request);
```

```swift response
import Foundation

let headers = [
  "Accept": "application/json",
  "X-Auth-Token": "<apiKey>"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://api.bigcommerce.com/stores/store_hash/v3/themes")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```