---
title: "List team flags"
method: GET
path: "/empower/flags"
tags: ["empower"]
---

# List team flags

`GET /empower/flags`

Retrieves all flags configured for your team. Flags are labels that can be associated with calls for categorization and tracking.

**Permission:** `Empower Read` required.

**Monitoring:** No impact.

## Response `200`

Successful operation

- object[]
  - `flag_id` string — Flag identifier
  - `team_id` integer — Team identifier
  - `name` string — Flag name
  - `description` string — Flag description
  - `color` string — Flag color
  - `created_by` integer — User ID who created the flag
  - `reason` string — Reason for the flag
  - `creation_date` string, date-time — Flag creation date
  - `update_date` string, date-time — Flag last update date

## Other responses

- `204` — No content — no flags configured for your team.
- `400` — Bad request.
- `401` — Unauthorized — missing or invalid token, or insufficient Empower Read permission.
- `500` — Internal server error.

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)