---
title: "List feature flags"
method: GET
path: "/admin/flags"
tags: ["FeatureFlag"]
---

# List feature flags

`GET /admin/flags`

## Request

- Base URL: `https://api.testnet.rise.trade`
- URL: `https://api.testnet.rise.trade/admin/flags`
- Auth: none required
- TypeScript: <https://skmtc.dev/rise/apis/risex-rest-api/docs/admin/flags/get.ts> (a function with typed inputs; its response is checked against the schema)

List feature flags with optional search/status filter and pagination.

## Query parameters

- `search` string
- `status` string
- `page` integer
- `limit` integer

## Response `200`

A successful response.

- ApiListFeatureFlagsResponse
  - `flags` ApiFeatureFlagInfo[]
    - `key` string: Stable identifier (lowercase alphanumeric + . - _, 3-100 chars).
    - `name` string: Human-readable name shown in the admin panel.
    - `description` string: Free-form description.
    - `enabled` boolean: Master switch: when false, IsEnabled returns false for every wallet.
    - `default_access` string: "whitelist": only listed wallets see the flag when enabled. "public": all wallets see the flag when enabled.
    - `created_by` string: Wallet address of the admin who created this flag.
    - `created_at` string, int64: Unix nanoseconds.
    - `updated_at` string, int64: Unix nanoseconds.
    - `is_internal` boolean: Internal-only flags are excluded from GetFlagsByWallet's public response.
  - `total` integer

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-11-03** `98eabcd6a6ad`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rise/apis/risex-rest-api/changes/admin/flags/get.md)

---

[API](https://skmtc.dev/rise/apis/risex-rest-api.md) - [All operations](https://skmtc.dev/rise/apis/risex-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rise/apis/risex-rest-api/revisions/98eabcd6a6ad?raw)
