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

# List apps

`GET /v2/apps`

List apps with optional filtering by labels or layer.

Use `labels[key]=value` query parameters to filter by label values. Use `layer` to filter apps that reference a specific layer.

## Query parameters

- `cursor` string
- `limit` integer
- `labels` Labels
- `layer` string

## Response `200`

OK

- AppListItem[]
  - `id` string, uuid, required — Unique app identifier (UUID)
  - `slug` string, required — Human-readable app slug. App slugs must be 3–32 characters long, may contain only lowercase letters, numbers, and hyphens, cannot contain underscores, must not start or end with a hyphen, must not have consecutive hyphens in positions 3 and 4, and cannot be a reserved slug.
  - `labels` Labels
  - `layers` LayerRef[], required — Layers referenced by this app, in priority order (later overrides earlier)
    - `id` string, required — Unique layer identifier
    - `slug` string, required — Human-readable layer slug
  - `updated_at` string, required — ISO 8601 timestamp of last modification
  - `created_at` string, required — ISO 8601 timestamp of creation

---

[API](https://skmtc.net/deno/apis/deploy.md) · [All operations](https://skmtc.net/deno/apis/deploy/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/deno/deploy/revisions/5a56038d108e/schema)