---
title: "List flags for application"
method: GET
path: "/apps/{appId}/flags"
---

# List flags for application

`GET /apps/{appId}/flags`

Retrieve all flags for a specific application

## Path parameters

- `appId` string, required — App identifier

## Response `200`

Requested resource retrieved successfully

- FlagHeaderCollection — Collection response containing flags
  - `data` FlagHeader[], required — Page of the collection of flags
    - `id` string, required — Flag ID
    - `key` string, required — Unique flag key
    - `name` string, required — Flag name
    - `description` string — Flag description
    - `stage` StageHeader — Stage's basic information
      - `id` string, required — Stage identifier
      - `name` string, required — Stage name
      - `color` string, required — Stage color (HTML color name or hex code)
      - `order` integer, required — Stage order
    - `owner` ReflagUserHeader — Reflag user's basic information
      - `id` string, required — Reflag user identifier
      - `name` string, required — User's name
      - `email` string, email, required — User's email
      - `avatarUrl` string, uri — User's avatar URL
    - `archived` boolean, required — Whether the flag is archived
    - `stale` boolean, required — Whether the flag is stale
    - `permanent` boolean, required — Whether the flag is permanent
    - `createdAt` string — Timestamp when the flag was created
    - `rolledOutToEveryoneAt` string — Timestamp when the flag was rolled out to everyone
    - `codeRefsCleanedUp` boolean, required — Whether code references for this flag have been cleaned up
    - `codeRefsMarkedCleanUserName` string — Name of the user who marked code references as cleaned up
    - `codeRefsMarkedCleanAt` string — Timestamp when code references were marked as cleaned up
    - `lastCheckAt` string — Timestamp when the flag was last checked
    - `noRecentChecks` boolean, required — Whether the flag has no recent access checks
    - `lastTrackAt` string — Timestamp when the flag was last tracked
  - `totalCount` integer, required — Total number of flags in collection
  - `pageSize` integer, required — Page size
  - `pageIndex` integer, required — Page index
  - `sortBy` 'name' | 'key' | 'stage' | 'autoFeedbackSurveysEnabled' | 'createdAt' | 'rolledOutToEveryoneAt' | 'environmentStatus' | 'owner' | 'lastCheck' | 'lastTrack' | 'stale' | 'archivingChecks', required — Sort by
  - `sortOrder` 'asc' | 'desc', required — Sort order applied to the sorting column

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Requested resource, or its parent, not found

---

[API](https://skmtc.net/reflag/apis/reflag-management-api.md) · [All operations](https://skmtc.net/reflag/apis/reflag-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/reflag/reflag-management-api/versions/9063276689b5/schema)