**Version: 202601**

# List app embeds

**GET** `/openapi/2026-01/themes/apps`

List the embed cards (app embeds) provided by the store's installed apps, plus injected script tags.

## Request

**Query Parameters**

- `limit` int32

  Max number of app-embed blocks to return, default no cap. Does not affect `script_tag_apps`

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `app_embeds` object[]

    App-embed blocks provided by the store's installed apps; each item is a free-form JSON object
  - `script_tag_apps` object[]

    Script tags grouped by app

    *   Array \[

    - `app_info` object

      App metadata

      - `id` int64

        App internal ID
      - `icon` string

        App icon URL
      - `uid` string

        App UID (client ID)
      - `name` string

        App name (internal)
      - `title` string

        App display title
      - `link` string

        App entry link (relative path)
      - `subtitle` string

        App subtitle / short description
      - `installed_at` string

        App installation time (RFC3339)
    - `script_tags` object[]

      Script tags owned by this app

      *   Array \[

      - `id` string

        Script tag UUID
      - `name` string

        Script tag name
      - `app_id` string

        Application ID that owns this script tag
      - `source` string

        Source: custom (merchant-defined) or public (operations platform)
      - `device` string

        Target device: `all`, `mobile`, `pc`
      - `display_scope` string

        Display scope (which pages)
      - `event_type` string

        Script event type
      - `src` string

        Script content or URL
      - `status` string

        Status: open (active) or close (inactive)
      - `position` string

        JS loading position
      - `store_id` string

        Store ID owning the script tag
      - `store_domain` string

        Target store domain (empty = all stores)
      - `event_period` string

        Effective period, e.g. permanent
      - `env` string

        Environment, e.g. staging / production
      - `exclude_ids` string

        Excluded page IDs
      - `weight` string

        Weight for ordering (string form)
      - `started_at` string

        Start time, unix seconds string (`0` = none)
      - `ended_at` string

        End time, unix seconds string (`0` = none)
      - `created_at` string

        Created time
      - `updated_at` string

        Updated time
      *   \]
    *   \]

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "app_embeds": [
      {}
    ],
    "script_tag_apps": [
      {
        "app_info": {
          "id": 0,
          "icon": "string",
          "uid": "string",
          "name": "string",
          "title": "string",
          "link": "string",
          "subtitle": "string",
          "installed_at": "string"
        },
        "script_tags": [
          {
            "id": "string",
            "name": "string",
            "app_id": "string",
            "source": "string",
            "device": "string",
            "display_scope": "string",
            "event_type": "string",
            "src": "string",
            "status": "string",
            "position": "string",
            "store_id": "string",
            "store_domain": "string",
            "event_period": "string",
            "env": "string",
            "exclude_ids": "string",
            "weight": "string",
            "started_at": "string",
            "ended_at": "string",
            "created_at": "string",
            "updated_at": "string"
          }
        ]
      }
    ]
  }
}
```