---
title: "List flag whitelist"
method: GET
path: "/admin/flags/{flag_key}/wallets"
tags: ["FeatureFlag"]
---

# List flag whitelist

`GET /admin/flags/{flag_key}/wallets`

## Request

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

List wallets currently whitelisted for a feature flag, with optional prefix search.

## Path parameters

- `flag_key` string, required

## Query parameters

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

## Response `200`

A successful response.

- ApiListFlagWalletsResponse
  - `wallets` ApiFlagWalletInfo[]
    - `wallet` string: Wallet address (lowercase hex with 0x prefix).
    - `note` string: Free-form note attached when this wallet was added.
    - `added_by` string: Admin wallet that added this entry.
    - `created_at` string, int64: Unix nanoseconds.
  - `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/:flag_key/wallets/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)