---
title: "GET /api/v1/namespaces/{namespaceKey}/flags"
method: GET
path: "/api/v1/namespaces/{namespaceKey}/flags"
tags: ["Flipt", "FlagsService"]
---

# GET /api/v1/namespaces/{namespaceKey}/flags

`GET /api/v1/namespaces/{namespaceKey}/flags`

## Request

- Base URL: `http://localhost:8080`
- URL: `http://localhost:8080/api/v1/namespaces/{namespaceKey}/flags`
- Auth: HTTP bearer

## Path parameters

- `namespaceKey` string, required

## Query parameters

- `limit` integer
- `offset` integer
- `pageToken` string
- `reference` string

## Response `200`

OK

- FlagList
  - `flags` Flag[]
    - `key` string
    - `name` string
    - `description` string
    - `enabled` boolean
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `variants` Variant[]
      - `id` string
      - `flagKey` string
      - `key` string
      - `name` string
      - `description` string
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
      - `attachment` string
      - `namespaceKey` string
    - `namespaceKey` string
    - `type` 'VARIANT_FLAG_TYPE' | 'BOOLEAN_FLAG_TYPE', enum
    - `defaultVariant` Variant
      - `id` string
      - `flagKey` string
      - `key` string
      - `name` string
      - `description` string
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
      - `attachment` string
      - `namespaceKey` string
    - `metadata` object
  - `nextPageToken` string
  - `totalCount` integer

## Changes

- **2024-08-08** `594afc3dbe2e`: 1 breaking, 2 warning
  - the `flags/items/type` response's property type changed from `integer` to `string` for status `200`
  - added the new `BOOLEAN_FLAG_TYPE` enum value to the `flags/items/type` response property for the response status `200`
  - added the new `VARIANT_FLAG_TYPE` enum value to the `flags/items/type` response property for the response status `200`
- **2024-08-07** `291b2f802c58`: 1 breaking, 2 info
  - the `flags/items/type` response's property type changed from `string` to `integer` for status `200`
  - removed the `BOOLEAN_FLAG_TYPE` enum value from the `flags/items/type` response property for the response status `200`
  - removed the `VARIANT_FLAG_TYPE` enum value from the `flags/items/type` response property for the response status `200`

[Operation history](https://skmtc.dev/flipt-io/apis/flipt-api/changes/api/v1/namespaces/:namespaceKey/flags/get.md)

---

[API](https://skmtc.dev/flipt-io/apis/flipt-api.md) - [All operations](https://skmtc.dev/flipt-io/apis/flipt-api/llms.txt) - [OpenAPI document](https://skmtc.dev/flipt-io/apis/flipt-api/revisions/6fe4caf26f13?raw)