---
title: "List apps"
method: GET
path: "/api/v1/apps"
tags: ["Apps"]
---

# List apps

`GET /api/v1/apps`

Returns paginated app list with filtering. Response schema varies by API version.

## Query parameters

- `page` integer — Page number (1-indexed)
- `page_size` integer — Items per page
- `search` string, nullable — Search name, app_id, vm_uuid, instance_id
- `status` string[], nullable — CVM status filter
- `listed` boolean, nullable — Listed status filter
- `base_image` string, nullable — OS image name filter
- `instance_type` string, nullable — Instance type filter
- `kms_slug` string, nullable — KMS slug filter
- `kms_type` string, nullable — KMS type filter
- `node` string, nullable — Node name filter (matches teepod or node name)
- `region` string, nullable — Region identifier filter

## Response `200`

Paginated app list

- union
  - TeehouseApiRoutesAppsV20251028SchemasDstackAppListResponse
    - `dstack_apps` union[], required
      - union
        - TeehouseApiRoutesAppsV20251028SchemasDstackAppFullResponse
          - `id` string, hashid, required — A hashed identifier that maps to an internal database ID
          - `name` string, required
          - `app_id` string, required
          - `app_provision_type` string, nullable
          - `app_icon_url` string, nullable
          - `created_at` string, required
          - `kms_type` string, required
          - `profile` ProfileGetResponse — Response model for entity profile - only public display data.
            - `display_name` string, nullable
            - `avatar_url` string, nullable
            - `description` string, nullable
            - `custom_domain` string, nullable
          - `current_cvm` TeehouseApiRoutesAppsV20251028SchemasCvmBasicInfo
            - `vm_uuid` string, nullable, required
            - `app_id` string, required
            - `name` string
            - `status` string, required
            - `vcpu` integer, required
            - `memory` integer, required
            - `disk_size` integer, required
            - `teepod_id` integer, required
            - `teepod_name` string, required
            - `region_identifier` string, nullable, required
            - `kms_type` string, nullable, required
            - `instance_type` string, nullable, required
            - `listed` boolean, nullable
            - `base_image` string, nullable
            - `kms_slug` string, nullable
            - `kms_id` string, nullable
            - `instance_id` string, nullable
            - `machine_info` MachineInfo — CVM hardware configuration.
              - …
            - `updated_at` string, date-time, nullable
          - `cvms` TeehouseApiRoutesAppsV20251028SchemasCvmBasicInfo[]
            - `vm_uuid` string, nullable, required
            - `app_id` string, required
            - `name` string
            - `status` string, required
            - `vcpu` integer, required
            - `memory` integer, required
            - `disk_size` integer, required
            - `teepod_id` integer, required
            - `teepod_name` string, required
            - `region_identifier` string, nullable, required
            - `kms_type` string, nullable, required
            - `instance_type` string, nullable, required
            - `listed` boolean, nullable
            - `base_image` string, nullable
            - `kms_slug` string, nullable
            - `kms_id` string, nullable
            - `instance_id` string, nullable
            - `machine_info` MachineInfo — CVM hardware configuration.
              - …
            - `updated_at` string, date-time, nullable
          - `cvm_count` integer
          - `team_slug` string, nullable
          - `team_name` string, nullable
        - DstackAppMinimalResponse
          - `id` unknown
          - `app_id` string, required
          - `name` unknown
          - `app_provision_type` unknown
          - `app_icon_url` unknown
          - `created_at` unknown
          - `kms_type` unknown
          - `profile` unknown
          - `current_cvm` unknown
          - `cvms` unknown
          - `cvm_count` unknown
    - `page` integer, required
    - `page_size` integer, required
    - `total` integer, required
    - `total_pages` integer, required
  - TeehouseApiRoutesAppsV20260121SchemasDstackAppListResponse
    - `dstack_apps` union[], required
      - union
        - TeehouseApiRoutesAppsV20260121SchemasDstackAppFullResponse
          - `id` string, hashid, required — A hashed identifier that maps to an internal database ID
          - `name` string, required
          - `app_id` string, required
          - `app_provision_type` string, nullable
          - `app_icon_url` string, nullable
          - `created_at` string, required
          - `kms_type` string, required
          - `profile` ProfileGetResponse — Response model for entity profile - only public display data.
            - `display_name` string, nullable
            - `avatar_url` string, nullable
            - `description` string, nullable
            - `custom_domain` string, nullable
          - `current_cvm` TeehouseApiRoutesCvmsV20260121SchemasCVMInfo
            - `id` string, hashid, required — A hashed identifier that maps to an internal database ID
            - `name` string, required
            - `app_id` string, nullable
            - `vm_uuid` string, nullable
            - `instance_id` string, nullable
            - `resource` CVMResourceInfo, required
              - …
            - `node_info` NodeRef — Minimal node/teepod reference for embedding in responses.
              - …
            - `os` CVMOSInfo
              - …
            - `kms_type` 'phala' | 'ethereum' | 'base' | 'legacy'
            - `kms_info` CVMKmsInfo
              - …
            - `status` string, required
            - `in_progress` boolean
            - `progress` CVMProgressInfo
              - …
            - `compose_hash` string, nullable
            - `docker_compose_hash` string, nullable
            - `pre_launch_script_hash` string, nullable
            - `gateway` CVMGatewayInfo, required
              - …
            - `logs` CVMLogUrls
              - …
            - `services` object[]
              - …
            - `endpoints` CvmNetworkUrls[], nullable
              - …
            - `public_logs` boolean
            - `public_sysinfo` boolean
            - `public_tcbinfo` boolean
            - `gateway_enabled` boolean
            - `secure_time` boolean
            - `storage_fs` string
            - `workspace` WorkspaceRef — Minimal workspace reference for embedding in responses.
              - …
            - `creator` UserRef — Minimal user reference for embedding in responses.
              - …
            - `created_at` string, date-time, nullable
            - `deleted_at` string, date-time, nullable
            - `listed` boolean
            - `project_type` string, nullable
          - `cvms` TeehouseApiRoutesCvmsV20260121SchemasCVMInfo[]
            - `id` string, hashid, required — A hashed identifier that maps to an internal database ID
            - `name` string, required
            - `app_id` string, nullable
            - `vm_uuid` string, nullable
            - `instance_id` string, nullable
            - `resource` CVMResourceInfo, required
              - …
            - `node_info` NodeRef — Minimal node/teepod reference for embedding in responses.
              - …
            - `os` CVMOSInfo
              - …
            - `kms_type` 'phala' | 'ethereum' | 'base' | 'legacy'
            - `kms_info` CVMKmsInfo
              - …
            - `status` string, required
            - `in_progress` boolean
            - `progress` CVMProgressInfo
              - …
            - `compose_hash` string, nullable
            - `docker_compose_hash` string, nullable
            - `pre_launch_script_hash` string, nullable
            - `gateway` CVMGatewayInfo, required
              - …
            - `logs` CVMLogUrls
              - …
            - `services` object[]
              - …
            - `endpoints` CvmNetworkUrls[], nullable
              - …
            - `public_logs` boolean
            - `public_sysinfo` boolean
            - `public_tcbinfo` boolean
            - `gateway_enabled` boolean
            - `secure_time` boolean
            - `storage_fs` string
            - `workspace` WorkspaceRef — Minimal workspace reference for embedding in responses.
              - …
            - `creator` UserRef — Minimal user reference for embedding in responses.
              - …
            - `created_at` string, date-time, nullable
            - `deleted_at` string, date-time, nullable
            - `listed` boolean
            - `project_type` string, nullable
          - `cvm_count` integer
        - DstackAppMinimalResponse
          - `id` unknown
          - `app_id` string, required
          - `name` unknown
          - `app_provision_type` unknown
          - `app_icon_url` unknown
          - `created_at` unknown
          - `kms_type` unknown
          - `profile` unknown
          - `current_cvm` unknown
          - `cvms` unknown
          - `cvm_count` unknown
    - `page` integer, required
    - `page_size` integer, required
    - `total` integer, required
    - `total_pages` integer, required

## Other responses

- `401` — Not authenticated
- `422` — Validation Error

---

[API](https://skmtc.net/phala/apis/phala-cloud-api.md) · [All operations](https://skmtc.net/phala/apis/phala-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/phala/phala-cloud-api/revisions/83c6ae62e860/schema)