**Version: 202701**

# List customization templates

**GET** `/openapi/2027-01/customization/templates`

Returns a paginated list of reusable customization templates for the current store.

## Request

**Query Parameters**

- `cursor` string

  Cursor for pagination
- `page_size` int32

  A limit on the number of objects to return. Range: 1-100 (default is 20)
- `page` int32

  Page number (1-based). Mutually exclusive with cursor
- `name` string

  Filter templates by name (fuzzy match)

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `templates` object[]

    Template list

    *   Array [

    - `id` string

      Template ID
    - `name` string

      Template name
    - `image` object

      Template cover image

      - `src` string

        Image URL
      - `width` int32

        Image width in pixels
      - `height` int32

        Image height in pixels
    - `updated_at` string

      Last updated time, ISO 8601
    - `related_product_count` int32

      Number of customizable products linked to this template
    *   ]
  - `cursor` string

    Cursor for the next page; empty when there are no more pages
  - `has_more` boolean

    Whether more records follow this page
  - `total` int32

    Total number of templates across all pages

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "templates": [
      {
        "id": "string",
        "name": "string",
        "image": {
          "src": "string",
          "width": 0,
          "height": 0
        },
        "updated_at": "string",
        "related_product_count": 0
      }
    ],
    "cursor": "string",
    "has_more": true,
    "total": 0
  }
}
```