**版本：202601**

# 查询单个主题文件的版本列表

**GET** `/openapi/2026-01/themes/:theme_id/doc/versions`

返回单个主题文件的版本历史列表。

## 请求

**Path参数**

- `theme_id` string (required)

  主题 ID

**Query参数**

- `type` string

  要查询版本的文件类型：`layout`、`templates`、`sections`、`snippets`、`assets`、`config`、`locales`（此接口不支持 `blocks`）。默认 `layout`
- `location` string

  文件在主题中的位置。默认为 theme.liquid

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `versions` object[]

    版本列表

    *   Array \[

    - `id` string

      主题文件版本 ID
    - `version` string

      版本
    - `created_at` string

      创建时间，ISO-8601 格式
    - `theme_id` string

      主题 ID
    - `type` string

      类型
    - `location` string

      位置信息
    - `updated_at` string

      最后更新时间，ISO-8601 格式（例如 `2023-01-01T00:00:00Z`）
    *   \]

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "versions": [
      {
        "id": "string",
        "version": "string",
        "created_at": "string",
        "theme_id": "string",
        "type": "string",
        "location": "string",
        "updated_at": "string"
      }
    ]
  }
}
```