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

# List Installed Apps

`GET /apps`

List all installed apps

## Query parameters

- `endpointId` integer — Endpoint ID to get apps from. If not set, get apps from the local endpoint

## Response `200`

Successful Response

- AppResponse[]
  - `app_id` string — App ID
  - `endpointId` integer — Endpoint ID(-1:Not install on app store)
  - `app_name` string, nullable — App name
  - `app_dist` string, nullable — App dist
  - `app_version` string, nullable — App version
  - `app_official` boolean — App official
  - `proxy_enabled` boolean — Proxy enabled
  - `status` integer — App status(0:unknown,1:active,2:inactive,3:installing,4:error)
  - `creationDate` integer, nullable — Creation date
  - `domain_names` object[] — Domain names
  - `env` object — Environment variables
  - `gitConfig` object — Git configuration
  - `containers` object[] — Containers
  - `volumes` object[] — Volumes
  - `error` string, nullable — Error message
  - `logs` unknown[], nullable — Logs
    - unknown

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

## Changes

- **2026-04-23** `e4bf692cc15e` — 5 breaking, 1 warning, 8 info
  - response property `items/app_dist` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/app_name` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/app_version` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/creationDate` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - …10 more

[Change history](https://skmtc.dev/websoft9/apis/appmanae-api/changes/apps/get.md)

---

[API](https://skmtc.dev/websoft9/apis/appmanae-api.md) · [All operations](https://skmtc.dev/websoft9/apis/appmanae-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/websoft9/appmanae-api/revisions/e4bf692cc15e/schema)