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

# List apps

`GET /apps`

## Request

- Base URL: `https://api.percher.run`
- URL: `https://api.percher.run/apps`
- Auth: HTTP bearer

## Query parameters

- `light` '1'

## Response `200`

List of apps

- App[]
  - `id` string
  - `name` string
  - `runtime` string
  - `framework` string, nullable
  - `status` 'provisioning' | 'live' | 'crashed' | 'suspended'
  - `url` string, uri
  - `dataMode` 'none' | 'pocketbase' | 'postgres' | 'sqlite' | 'convex' | 'supabase' | 'external'
  - `createdAt` string, date-time
  - `access` 'owner' | 'admin' | 'viewer': Caller's effective role. 'admin' grants the operational write surface (deploy, env, domains, KV, logs, PocketBase ops); 'viewer' is read-only; 'owner' is everything including delete / transfer / rename / share management.

---

[API](https://skmtc.dev/percher/apis/percher-api.md) · [All operations](https://skmtc.dev/percher/apis/percher-api/llms.txt) · [OpenAPI document](https://skmtc.dev/percher/apis/percher-api/revisions/d9e7089c21e5?raw)