--- title: List feature flags description: Datadog, the leading service for cloud-scale monitoring. breadcrumbs: Docs > API Reference > Feature Flags --- > For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt). # List feature flags{% #list-feature-flags %} {% tab title="v2" %} | Datadog site | API endpoint | | ----------------- | ------------------------------------------------------ | | ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/feature-flags | | ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/feature-flags | | app.datadoghq.eu | GET https://api.datadoghq.eu/api/v2/feature-flags | | app.ddog-gov.com | GET https://api.ddog-gov.com/api/v2/feature-flags | | us2.ddog-gov.com | GET https://api.us2.ddog-gov.com/api/v2/feature-flags | | uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/feature-flags | | app.datadoghq.com | GET https://api.datadoghq.com/api/v2/feature-flags | | us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/feature-flags | | us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/feature-flags | ### Overview Returns a paginated list of feature flags for the organization. Supports filtering by key, tags, teams, SDK availability, production status, and other flag properties. Use `page[limit]` and `page[offset]` to paginate, or follow the `next` link in the response. This endpoint requires all of the following permissions: `feature_flag_config_read``feature_flag_environment_config_read` OAuth apps require the `feature_flag_config_read, feature_flag_environment_config_read` authorization [scope](https://docs.datadoghq.com/api/latest/scopes.md#feature-flags) to access this endpoint. ### Arguments #### Query Strings | Name | Type | Description | | -------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | key | string | Filter feature flags by an exact, case-sensitive key. Use `search` for partial matching. | | is_archived | boolean | Filter by archived status. If `true`, return only archived flags. If `false`, return only flags that are not archived. If omitted, return both. | | limit | integer | Deprecated alias for `page[limit]`. Use `page[limit]` for new requests. Used only when `page[limit]` is absent. When both parameters are omitted, the server defaults to `25`. Values that exceed `50` are set to `50`; non-positive or empty values use the server default. | | offset | integer | Deprecated alias for `page[offset]`. Used only when `page[offset]` is absent. Defaults to `0`. Negative or empty values are set to `0`. | | tags | array | Filter by exact tag values using repeated parameters, such as `tags=env:prod&tags=purpose:sitemap`. A flag must have all ordinary tags. Values of the form `team:` match any selected team and are combined with `teams` into one set. The result must match all ordinary tags, any selected team, and all other filters. Empty values are ignored. | | teams | array | Filter by team handles without the `team:` prefix. Use repeated parameters to filter by multiple team handles, such as `teams=checkout&teams=payments`. A flag must belong to at least one selected team. Team handles from `teams` and `team:` values from tags are treated as a single set and combined with ordinary tags and other filters using AND logic. Duplicate handles do not duplicate results. Unknown handles do not match any flags. Empty handles, surrounding white space, or using the `team:` prefix return a bad request error. Response tags are unchanged. | | production_status | array | Filter by status across production environments. Use repeated parameters to match any selected status. `ENABLED` matches at least one enabled production environment without a variant override. `OVERRIDDEN` matches at least one enabled production environment with a variant override. `DISABLED` matches flags whose associated production environments are all disabled. A flag can match both `ENABLED` and `OVERRIDDEN` in different environments. Flags without associated production environments do not match. This does not filter by a specific environment. Unknown values do not match any status. | | distribution_channel | enum | Filter by SDK availability. `CLIENT` returns flags with channel `CLIENT` or `ALL`. `SERVER` returns flags with channel `SERVER` or `ALL`. `ALL`, an empty value, or omission applies no channel restriction; it does not select only flags whose channel is `ALL`. Values are case-insensitive and surrounding white space is ignored. Invalid values return a bad request error. Allowed enum values: `ALL, CLIENT, SERVER` | | search | string | Case-insensitive substring search on flag names, keys, and tag names. Combined with all other filters. An empty value applies no search restriction. | | value_type | array | Filter by variant value types using repeated parameters. A flag must match at least one selected type. Empty values are ignored. Invalid types return a bad request error. | | created_by | array | Filter by creator UUIDs using repeated parameters. A flag must match at least one creator. Empty values are ignored. Invalid UUIDs return a bad request error. | | flag_ids | array | Filter by feature flag UUIDs using repeated parameters. A flag must match at least one ID and all other filters. Duplicate IDs return each flag once. Unknown IDs and IDs from other organizations do not match any flags. Empty or invalid UUIDs return a bad request error. Pagination still applies. | | staleness_status | enum | Filter by the computed staleness status: `ACTIVE`, `STALE`, or `PERMANENT`. Values are case-insensitive and surrounding white space is ignored. An empty value or omission applies no restriction. Invalid values return a bad request error. Read the computed result from `staleness_details.staleness_status`, not the legacy `staleness_status` response field. Allowed enum values: `ACTIVE, STALE, PERMANENT` | | saved_filter_id | string | Filter to flags that reference this saved filter in their targeting conditions. An empty value or omission applies no restriction. An invalid UUID returns a bad request error. | | sort | string | Sort by `name`, `updated_at`, `created_at`, or `evaluations`. Use a comma-separated list for multiple sort fields and prefix a field with `-` for descending order. The default is `updated_at` descending. When favorites are enabled, the authenticated user's favorite flags take precedence over the selected ordering. Unknown fields return a bad request error. | | page[limit] | integer | Maximum number of flags to return. Defaults to `25` and is capped at `50`. Values that exceed `50` are set to `50`. Non-positive or empty values use the default. A non-integer value returns a bad request error. Takes precedence over `limit` when both are present. Pagination applies even when no pagination parameters are supplied. | | page[offset] | integer | Number of matching flags to skip before returning results. Defaults to `0`. Negative or empty values are set to `0`. A non-integer value returns a bad request error. Takes precedence over `offset` when both are present. | ### Response {% tab title="200" %} OK {% tab title="Model" %} Response containing a list of feature flags. | Parent field | Field | Type | Description | | ------------------------- | -------------------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | data [*required*] | [object] | List of feature flags. | | data | attributes [*required*] | object | Attributes of a feature flag in list responses. | | attributes | archived_at | date-time | The timestamp when the feature flag was archived. | | attributes | created_at | date-time | The timestamp when the feature flag was created. | | attributes | created_by | uuid | The ID of the user who created the feature flag. | | attributes | description [*required*] | string | The description of the feature flag. | | attributes | distribution_channel | string | Distribution channel for the feature flag. | | attributes | feature_flag_environments | [object] | Environment-specific settings for the feature flag. | | feature_flag_environments | default_allocation_key | string | The allocation key used for the default variant. | | feature_flag_environments | default_variant_id | string | The ID of the default variant for this environment. | | feature_flag_environments | environment_id [*required*] | uuid | The ID of the environment. | | feature_flag_environments | environment_name | string | The name of the environment. | | feature_flag_environments | environment_queries | [string] | Queries that target this environment. | | feature_flag_environments | is_production | boolean | Indicates whether the environment is production. | | feature_flag_environments | observe_full_evaluation_data | boolean | Indicates whether feature flag evaluation events include original targeting identifiers and full evaluation context. | | feature_flag_environments | override_allocation_key | string | The allocation key used for the override variant. | | feature_flag_environments | override_variant_id | string | The ID of the override variant for this environment. | | feature_flag_environments | pending_suggestion_id | string | Pending suggestion identifier, if approval is required. | | feature_flag_environments | require_feature_flag_approval | boolean | Indicates whether feature flag changes require approval in this environment. | | feature_flag_environments | status [*required*] | enum | The status of a feature flag in an environment. Allowed enum values: `ENABLED,DISABLED` | | attributes | is_favorite | boolean | Indicates whether the current user has marked the feature flag as a favorite. | | attributes | json_schema | string | JSON schema for validation when value_type is JSON. | | attributes | key [*required*] | string | The unique key of the feature flag. | | attributes | last_updated_by | uuid | The ID of the user who last updated the feature flag. | | attributes | name [*required*] | string | The name of the feature flag. | | attributes | require_approval | boolean | Indicates whether this feature flag requires approval for changes. | | attributes | staleness_details | object | The feature flag's current staleness state and suggested actions. | | staleness_details | code_references | [object] | Repositories and files where the flag is referenced in source code. | | code_references | files | [string] | Paths of files that reference the feature flag in this repository. | | code_references | repo_url | string | The URL of the source code repository, when available. | | code_references | scm_repository_id | string | The identifier of the source code repository. | | staleness_details | dismissed_by | string | The ID of the user who dismissed the staleness recommendation. | | staleness_details | id | string | The ID of the feature flag whose staleness state is returned. | | staleness_details | recommended_actions | [object] | Suggested actions for the flag. The first action is the primary recommendation. | | recommended_actions | action | string | The action to consider. Values include `remove_from_code`, `archive_flag`, `mark_as_permanent`, `snooze`, and `check_sdk_config`. | | recommended_actions | description | string | An explanation of the suggested action. | | staleness_details | skip_state_check_until | date-time | Time until which staleness checks are paused for the flag. | | staleness_details | stale_reason | string | Why the flag is stale or has a manually selected state. Values include `FULLY_ROLLED_OUT`, `NO_EVALUATIONS`, `NO_ACTIVITY`, and `USER_SET`. | | staleness_details | staleness_status | string | The current state, such as `ACTIVE`, `STALE`, or `PERMANENT`. | | attributes | staleness_status | string | **DEPRECATED**: Legacy status retained for compatibility. This field is always `ACTIVE`; use `staleness_details.staleness_status` for the computed status. | | attributes | staleness_status_override | enum | An explicit staleness status override. Omitted when no override is set. Allowed enum values: `STALE,PERMANENT` | | attributes | tags | [string] | Tags associated with the feature flag. | | attributes | updated_at | date-time | The timestamp when the feature flag was last updated. | | attributes | value_type [*required*] | enum | The type of values for the feature flag variants. Allowed enum values: `BOOLEAN,INTEGER,NUMERIC,STRING,JSON` | | attributes | variants [*required*] | [object] | The variants of the feature flag. | | variants | created_at | date-time | The timestamp when the variant was created. | | variants | id [*required*] | uuid | The unique identifier of the variant. | | variants | key [*required*] | string | The unique key of the variant. | | variants | name [*required*] | string | The name of the variant. | | variants | updated_at | date-time | The timestamp when the variant was last updated. | | variants | value [*required*] | string | The value of the variant as a string. | | data | id [*required*] | uuid | The unique identifier of the feature flag. | | data | type [*required*] | enum | The resource type. Allowed enum values: `feature-flags` | | | links | object | Pagination links. Follow `next` with the same authentication to retrieve the next page. Links use `page[limit]` and `page[offset]` and preserve the filters. Navigation links are omitted when not applicable. | | links | first | string | Link to the first page. | | links | last | string | Link to the last page. | | links | next | string | Link to the next page, when available. | | links | prev | string | Link to the previous page, when available. | | links | self | string | Link to the current page. | | | meta | object | Pagination metadata for feature flags. | | meta | page | object | Pagination metadata for feature flags list responses. | | page | first_offset | int64 | Offset of the first page. | | page | last_offset | int64 | Offset of the last page. | | page | limit | int64 | Maximum number of flags returned on this page. | | page | next_offset | int64 | Offset of the next page, or null when there is no next page. | | page | offset | int64 | Number of matching flags skipped before this page. | | page | prev_offset | int64 | Offset of the previous page, or null when there is no previous page. | | page | total | int64 | Total number of flags matching the filters, independent of the page size. | | page | total_count | int64 | **DEPRECATED**: Legacy count field. Use `total` for the number of matching flags. | | page | total_filtered_count | int64 | **DEPRECATED**: Legacy filtered count field. Use `total` for the number of matching flags. | | page | type | string | The pagination method. Always `offset_limit`. | {% /tab %} {% tab title="Example" %} ```json { "data": [ { "attributes": { "archived_at": "2023-01-01T00:00:00Z", "created_at": "2023-01-01T00:00:00Z", "created_by": "550e8400-e29b-41d4-a716-446655440010", "description": "This is an example feature flag for demonstration", "distribution_channel": "ALL", "feature_flag_environments": [ { "default_allocation_key": "allocation-default-123abc", "default_variant_id": "550e8400-e29b-41d4-a716-446655440002", "environment_id": "550e8400-e29b-41d4-a716-446655440001", "environment_name": "env-search-term", "environment_queries": [ "test-feature-flag", "env-search-term" ], "is_production": false, "observe_full_evaluation_data": false, "override_allocation_key": "allocation-override-123abc", "override_variant_id": "550e8400-e29b-41d4-a716-446655440003", "pending_suggestion_id": "550e8400-e29b-41d4-a716-446655440099", "require_feature_flag_approval": false, "status": "ENABLED" } ], "is_favorite": false, "json_schema": "{\"type\": \"object\", \"properties\": {\"enabled\": {\"type\": \"boolean\"}}}", "key": "feature-flag-abc123", "last_updated_by": "550e8400-e29b-41d4-a716-446655440010", "name": "Feature Flag ABC123", "require_approval": false, "staleness_details": { "code_references": [ { "files": [ "src/feature_flags.ts" ], "repo_url": "https://github.com/example/application", "scm_repository_id": "repository-1" } ], "dismissed_by": "550e8400-e29b-41d4-a716-446655440010", "id": "550e8400-e29b-41d4-a716-446655440000", "recommended_actions": [ { "action": "archive_flag", "description": "Archive the feature flag." } ], "skip_state_check_until": "2026-09-30T12:00:00Z", "stale_reason": "NO_EVALUATIONS", "staleness_status": "ACTIVE" }, "staleness_status": "ACTIVE", "staleness_status_override": "PERMANENT", "tags": [ [] ], "updated_at": "2023-01-01T00:00:00Z", "value_type": "BOOLEAN", "variants": [ { "created_at": "2023-01-01T00:00:00Z", "id": "550e8400-e29b-41d4-a716-446655440002", "key": "variant-abc123", "name": "Variant ABC123", "updated_at": "2023-01-01T00:00:00Z", "value": "true" } ] }, "id": "550e8400-e29b-41d4-a716-446655440000", "type": "feature-flags" } ], "links": { "first": "https://api.datadoghq.com/api/v2/feature-flags?page%5Blimit%5D=25\u0026page%5Boffset%5D=0", "last": "https://api.datadoghq.com/api/v2/feature-flags?page%5Blimit%5D=25\u0026page%5Boffset%5D=75", "next": "https://api.datadoghq.com/api/v2/feature-flags?page%5Blimit%5D=25\u0026page%5Boffset%5D=25", "prev": "https://api.datadoghq.com/api/v2/feature-flags?page%5Blimit%5D=25\u0026page%5Boffset%5D=0", "self": "https://api.datadoghq.com/api/v2/feature-flags?page%5Blimit%5D=25\u0026page%5Boffset%5D=0" }, "meta": { "page": { "first_offset": 0, "last_offset": 75, "limit": 25, "next_offset": 25, "offset": 0, "prev_offset": 0, "total": 100, "total_count": 100, "total_filtered_count": 25, "type": "offset_limit" } } } ``` {% /tab %} {% /tab %} {% tab title="400" %} Bad Request {% tab title="Model" %} API error response. | Parent field | Field | Type | Description | | ------------ | ------------------------ | -------- | ------------------------------------------------------------------------------- | | | errors [*required*] | [object] | A list of errors. | | errors | detail | string | A human-readable explanation specific to this occurrence of the error. | | errors | meta | object | Non-standard meta-information about the error | | errors | source | object | References to the source of the error. | | source | header | string | A string indicating the name of a single request header which caused the error. | | source | parameter | string | A string indicating which URI query parameter caused the error. | | source | pointer | string | A JSON pointer to the value in the request document that caused the error. | | errors | status | string | Status code of the response. | | errors | title | string | Short human-readable summary of the error. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ { "detail": "Missing required attribute in body", "meta": {}, "source": { "header": "Authorization", "parameter": "limit", "pointer": "/data/attributes/title" }, "status": "400", "title": "Bad Request" } ] } ``` {% /tab %} {% /tab %} {% tab title="403" %} Forbidden {% tab title="Model" %} API error response. | Field | Type | Description | | ------------------------ | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} {% tab title="429" %} Too many requests {% tab title="Model" %} API error response. | Field | Type | Description | | ------------------------ | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} ### Code Example ##### \# Use a Personal Access Token or Service Access Token export DD_BEARER_TOKEN="" \# Curl command curl -X GET "https://api.datadoghq.com/api/v2/feature-flags" \ -H "Accept: application/json" \ -H "Authorization: Bearer ${DD_BEARER_TOKEN}" ##### ```python """ List feature flags returns "OK" response """ from os import environ from datadog_api_client import ApiClient, Configuration from datadog_api_client.v2.api.feature_flags_api import FeatureFlagsApi configuration = Configuration() configuration.access_token = environ["DD_BEARER_TOKEN"] with ApiClient(configuration) as api_client: api_instance = FeatureFlagsApi(api_client) response = api_instance.list_feature_flags( limit=10, ) print(response) ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=python) and then save the example to `example.py` and run following commands: DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" python3 "example.py" ##### ```ruby # List feature flags returns "OK" response require "datadog_api_client" DatadogAPIClient.configure do |config| config.access_token = ENV["DD_BEARER_TOKEN"] end api_instance = DatadogAPIClient::V2::FeatureFlagsAPI.new opts = { limit: 10, } p api_instance.list_feature_flags(opts) ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=ruby) and then save the example to `example.rb` and run following commands: DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" rb "example.rb" ##### ```go // List feature flags returns "OK" response package main import ( "context" "encoding/json" "fmt" "os" "github.com/DataDog/datadog-api-client-go/v2/api/datadog" "github.com/DataDog/datadog-api-client-go/v2/api/datadogV2" ) func main() { ctx := datadog.NewDefaultContext(context.Background()) ctx = context.WithValue(ctx, datadog.ContextAccessToken, os.Getenv("DD_BEARER_TOKEN")) configuration := datadog.NewConfiguration() apiClient := datadog.NewAPIClient(configuration) api := datadogV2.NewFeatureFlagsApi(apiClient) resp, r, err := api.ListFeatureFlags(ctx, *datadogV2.NewListFeatureFlagsOptionalParameters().WithLimit(10)) if err != nil { fmt.Fprintf(os.Stderr, "Error when calling `FeatureFlagsApi.ListFeatureFlags`: %v\n", err) fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r) } responseContent, _ := json.MarshalIndent(resp, "", " ") fmt.Fprintf(os.Stdout, "Response from `FeatureFlagsApi.ListFeatureFlags`:\n%s\n", responseContent) } ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=go) and then save the example to `main.go` and run following commands: DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" go run "main.go" ##### ```java // List feature flags returns "OK" response import com.datadog.api.client.ApiClient; import com.datadog.api.client.ApiException; import com.datadog.api.client.v2.api.FeatureFlagsApi; import com.datadog.api.client.v2.api.FeatureFlagsApi.ListFeatureFlagsOptionalParameters; import com.datadog.api.client.v2.model.ListFeatureFlagsResponse; public class Example { public static void main(String[] args) { ApiClient defaultClient = ApiClient.getDefaultApiClient(); defaultClient.setAccessToken(System.getenv("DD_BEARER_TOKEN")); FeatureFlagsApi apiInstance = new FeatureFlagsApi(defaultClient); try { ListFeatureFlagsResponse result = apiInstance.listFeatureFlags(new ListFeatureFlagsOptionalParameters().limit(10L)); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling FeatureFlagsApi#listFeatureFlags"); System.err.println("Status code: " + e.getCode()); System.err.println("Reason: " + e.getResponseBody()); System.err.println("Response headers: " + e.getResponseHeaders()); e.printStackTrace(); } } } ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=java) and then save the example to `Example.java` and run following commands: DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" java "Example.java" ##### ```rust // List feature flags returns "OK" response use datadog_api_client::datadog; use datadog_api_client::datadogV2::api_feature_flags::FeatureFlagsAPI; use datadog_api_client::datadogV2::api_feature_flags::ListFeatureFlagsOptionalParams; #[tokio::main] async fn main() { let configuration = datadog::Configuration::new(); let api = FeatureFlagsAPI::with_config(configuration); let resp = api .list_feature_flags(ListFeatureFlagsOptionalParams::default().limit(10)) .await; if let Ok(value) = resp { println!("{:#?}", value); } else { println!("{:#?}", resp.unwrap_err()); } } ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=rust) and then save the example to `src/main.rs` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" cargo run ##### ```typescript /** * List feature flags returns "OK" response */ import { client, v2 } from "@datadog/datadog-api-client"; const configuration = client.createConfiguration({ authMethods: { AuthZ: { accessToken: process.env.DD_BEARER_TOKEN as string, }, }, }); const apiInstance = new v2.FeatureFlagsApi(configuration); const params: v2.FeatureFlagsApiListFeatureFlagsRequest = { limit: 10, }; apiInstance .listFeatureFlags(params) .then((data: v2.ListFeatureFlagsResponse) => { console.log( "API called successfully. Returned data: " + JSON.stringify(data) ); }) .catch((error: any) => console.error(error)); ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=typescript) and then save the example to `example.ts` and run following commands: DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" tsc "example.ts" {% /tab %}