---
title: "List feature flags"
method: GET
path: "/api/v2/feature-flags"
tags: ["Feature Flags"]
---

# List feature flags

`GET /api/v2/feature-flags`

Returns a list of feature flags for the organization.
Supports filtering by key and archived status.

## Query parameters

- `key` string
- `is_archived` boolean
- `limit` integer
- `offset` integer

## Response `200`

OK

- ListFeatureFlagsResponse — Response containing a list of feature flags.
  - `data` FeatureFlagListItem[], required — List of feature flags.
    - `attributes` FeatureFlagListItemAttributes, required — Attributes of a feature flag in list responses.
      - `archived_at` string, date-time, nullable — The timestamp when the feature flag was archived.
      - `created_at` string, date-time — The timestamp when the feature flag was created.
      - `created_by` string, uuid — The ID of the user who created the feature flag.
      - `description` string, required — The description of the feature flag.
      - `distribution_channel` string — Distribution channel for the feature flag.
      - `feature_flag_environments` FeatureFlagEnvironmentListItem[] — Environment-specific settings for the feature flag.
        - `default_allocation_key` string — The allocation key used for the default variant.
        - `default_variant_id` string, nullable — The ID of the default variant for this environment.
        - `environment_id` string, uuid, required — The ID of the environment.
        - `environment_name` string — The name of the environment.
        - `environment_queries` string[] — Queries that target this environment.
        - `is_production` boolean — Indicates whether the environment is production.
        - `override_allocation_key` string — The allocation key used for the override variant.
        - `override_variant_id` string, nullable — The ID of the override variant for this environment.
        - `pending_suggestion_id` string, nullable — Pending suggestion identifier, if approval is required.
        - `require_feature_flag_approval` boolean — Indicates whether feature flag changes require approval in this environment.
        - `status` 'ENABLED' | 'DISABLED', required — The status of a feature flag in an environment.
      - `json_schema` string, nullable — JSON schema for validation when value_type is JSON.
      - `key` string, required — The unique key of the feature flag.
      - `last_updated_by` string, uuid — The ID of the user who last updated the feature flag.
      - `name` string, required — The name of the feature flag.
      - `require_approval` boolean — Indicates whether this feature flag requires approval for changes.
      - `staleness_status` string — Indicates the staleness status of the feature flag.
      - `tags` string[] — Tags associated with the feature flag.
      - `updated_at` string, date-time — The timestamp when the feature flag was last updated.
      - `value_type` 'BOOLEAN' | 'INTEGER' | 'NUMERIC' | 'STRING' | 'JSON', required — The type of values for the feature flag variants.
      - `variants` Variant[], required — The variants of the feature flag.
        - `created_at` string, date-time — The timestamp when the variant was created.
        - `id` string, uuid, required — The unique identifier of the variant.
        - `key` string, required — The unique key of the variant.
        - `name` string, required — The name of the variant.
        - `updated_at` string, date-time — The timestamp when the variant was last updated.
        - `value` string, required — The value of the variant as a string.
    - `id` string, uuid, required — The unique identifier of the feature flag.
    - `type` 'feature-flags', required — The resource type.
  - `meta` FeatureFlagsPaginationMeta — Pagination metadata for feature flags.
    - `page` FeatureFlagsPaginationMetaPage — Pagination metadata for feature flags list responses.
      - `total_count` integer — Total number of items.
      - `total_filtered_count` integer — Total number of items matching the filter.

## Other responses

- `403` — Forbidden
- `429` — Too many requests

---

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