---
title: "Get Theme by theme key"
method: GET
path: "/themes/{theme_key}"
tags: ["Themes"]
---

# Get Theme by theme key

`GET /themes/{theme_key}`

## Request

- Base URL: `https://open.shopline.io/v1`
- URL: `https://open.shopline.io/v1/themes/{theme_key}`
- Auth: HTTP bearer

To get theme with the theme_key<br>用theme_key請求該主題

## Path parameters

- `theme_key` string, required

## Response `200`

OK

- object
  - `items` Theme
    - `id` string: Id of the Theme<br>主題ID
    - `created_at` string: Created Time<br>主題創造時間
    - `updated_at` string: Updated Time<br>主題更新時間
    - `caption` string: Caption of the theme<br>主題的說明文字
    - `demo_url` string: Demo URL of the theme<br>主題的示範網址
    - `description` string: Description of the theme<br>主題的抽述
    - `highlight_url` string: Highlight URL of the theme<br>主題的網址
    - `key` string: Key of the theme<br>主題的鍵
    - `media_ids` string[]: The id of the medias that belongs to this theme<br>主題包含的媒體ID
    - `name` string: Name of the Theme<br>主題的名稱
    - `path` string: Path of the Theme<br>主題的路徑
    - `rollout_keys` string[]: Rollout Keys of the Theme<br>主題的 Rollout Keys
    - `status` 'active' | 'draft' | 'removed' | 'hidden': Status of the Theme<br>主題狀態
    - `type` string: Type of the Theme<br>主題類別
    - `support_new_page_builder` boolean: Support new page section type<br>這個theme是否支援section page格式
    - `new_page_builder_rollout_key` string: The merchant should have this rollout key in order to create or edit pages of this theme in NPB <br>店家需有這條 rollout key 才能在NPB創建／編輯這個主題的頁面
    - `support_new_plp` boolean: Support Product List Page<br>這個theme是否支援product list page
    - `new_plp_rollout_key` string: Rollout key of Product List Page<br> Product List Page 的 Rollout Key (用於判斷前台是否支援 PLP)

## Other responses

- `401`: Bad authentication
- `403`: Forbidden
- `500`: Server error

## Changes

- **2026-11-03** `d2518391b149`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/shoplineapp/apis/shopline-open-api/changes/themes/:theme_key/get.md)

---

[API](https://skmtc.dev/shoplineapp/apis/shopline-open-api.md) - [All operations](https://skmtc.dev/shoplineapp/apis/shopline-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shoplineapp/apis/shopline-open-api/revisions/d2518391b149?raw)