---
search:
  tags:
    - Themes
    - GET
seo:
  description: >-
    Returns the full theme entity including all embedded templates and assets.
    The production… Reference for the GET /themes/{id} endpoint in the Bolder
    API v2.
sidebar:
  label: Get a theme
  badge: GET
title: Get a theme
type: openapi-operation
---
Returns the full theme entity including all embedded templates and assets.
The `production` field indicates whether this is the live theme.
For the public/production theme, `store:create_dev_theme` is available.
For a dev theme, `store:publish_theme` and `store:delete_theme` are available.

`GET /themes/{id}`

**cURL**

```bash
curl -s -H "Authorization: Bearer $BOLDER_TOKEN" \
  "https://api.onbolder.com/v2/themes/abc123"
```

**Responses**

- `200` — Theme entity with embedded templates and assets
- `401` — Unauthorized
- `403` — Access denied
- `404` — Theme not found

Response example, 200:

```json
{
  "id": "abc123",
  "title": "My Theme",
  "production": true,
  "public": true,
  "accessible": true,
  "linked": false,
  "parent_id": null,
  "settings": "{\"bg_color\":\"#fff\"}",
  "created_on": "2023-06-01T10:00:00Z",
  "updated_on": "2024-11-15T09:30:00Z",
  "_links": {
    "self": {
      "href": "https://api.onbolder.com/v2/themes/abc123"
    },
    "store:update_theme": {
      "href": "https://api.onbolder.com/v2/themes/abc123",
      "method": "put"
    },
    "store:create_template": {
      "href": "https://api.onbolder.com/v2/themes/abc123/templates",
      "method": "post"
    },
    "store:create_theme_asset": {
      "href": "https://api.onbolder.com/v2/themes/abc123/assets",
      "method": "post"
    },
    "store:theme_preview": {
      "href": "https://myshop.onbolder.com",
      "type": "text/html"
    },
    "store:create_dev_theme": {
      "href": "https://api.onbolder.com/v2/shops/1/themes",
      "method": "post"
    }
  },
  "_embedded": {
    "templates": [
      {
        "id": "t1",
        "file_name": "layout.html",
        "name": "layout",
        "content_type": "text/html",
        "body": "<html>...</html>",
        "is_section": false,
        "updated_on": "2024-11-15T09:30:00Z"
      }
    ],
    "assets": [
      {
        "id": "a1",
        "file_name": "logo.png",
        "content_type": "image/png",
        "file_size": 12400,
        "url": "https://cdn.onbolder.com/themes/abc123/logo.png"
      }
    ]
  }
}
```