List themes

GET 
/openapi/2026-07/themes

Retrieve a list of all themes.

Request

Query Parameters

published string

Filter themes by published status. "0" for unpublished, "1" for published

cursor string

Cursor for pagination. Use the cursor returned in the previous response to retrieve the next page

page_size int32

Number of themes to return per page. Range: 1-250. Default is 10

ids string[]

List of theme IDs to filter by. Only themes matching the given IDs are returned. Example: ?ids=1001&ids=1002

contain_ext_theme boolean

Whether to include extension themes in the returned results

Responses

200

OK

application/json

Schema

Schema

codestring

error code

messagestring

error message

data object

countint32

Total number of themes available

themes object[]

Array of theme objects

Array [

idstring

Theme's unique identifier

namestring

Theme name

merchant_theme_idstring

Merchant theme ID

merchant_theme_namestring

Merchant theme name

merchant_theme_infostring

Theme version identifier

localestring

Theme locale (e.g., en-US, zh-CN)

presetstring

Theme style

typestring

Theme type:

• shoplazza: Internal shoplazza themes
• developer: Third-party developer themes

descstring

Multi-language description of the theme

defaultstring

Indicates if it's the default theme (0 or 1)

pc_cover_urlstring

URL for the PC cover image

mobile_cover_urlstring

URL for the mobile cover image

publishedstring

Indicates if the theme is published (0 or 1)

is_auto_upgradestring

Indicates if the theme is auto-upgraded

statusstring

The status of the theme

updated_atstring

Timestamp when the theme was last updated

publish_timestring

Publish timestamp

auto_save_timestring

Auto-save time

theme_save_timestring

Last theme save time

versionstring

Current theme version

c_versionstring

Current client version

change_logstring

Changelog information for the theme

version_publish_timestring

Version publishing time

newest_c_versionstring

Newest available client version

has_newest_versionboolean

Whether the theme has the newest version

has_draftboolean

Whether has draft

theme_version_idstring

The version ID of the theme

]

cursorstring

Cursor for the next page of results

has_moreboolean

Whether there are more records

Example

{
  "code": "string",
  "message": "string",
  "data": {
    "count": 0,
    "themes": [
      {
        "id": "string",
        "name": "string",
        "merchant_theme_id": "string",
        "merchant_theme_name": "string",
        "merchant_theme_info": "string",
        "locale": "string",
        "preset": "string",
        "type": "string",
        "desc": "string",
        "default": "string",
        "pc_cover_url": "string",
        "mobile_cover_url": "string",
        "published": "string",
        "is_auto_upgrade": "string",
        "status": "string",
        "updated_at": "string",
        "publish_time": "string",
        "auto_save_time": "string",
        "theme_save_time": "string",
        "version": "string",
        "c_version": "string",
        "change_log": "string",
        "version_publish_time": "string",
        "newest_c_version": "string",
        "has_newest_version": true,
        "has_draft": true,
        "theme_version_id": "string"
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}