List feature flag statuses

For the complete documentation index, see llms.txt. For the full documentation snapshot, see llms-full.txt.

Get a list of statuses for all feature flags. The status includes the last time the feature flag was requested, as well as a state, which is one of the following:

• new: You created the flag fewer than seven days ago and it has never been requested.
• active: LaunchDarkly is receiving requests for this flag, but there are either multiple variations configured, or it is toggled off, or there have been changes to configuration in the past seven days.
• inactive: You created the feature flag more than seven days ago, and hasn’t been requested within the past seven days.
• launched: LaunchDarkly is receiving requests for this flag, it is toggled on, there is only one variation configured, and there have been no changes to configuration in the past seven days.

To learn more, read Flag statuses.

GET /api/v2/flag-statuses/{projectKey}/{environmentKey}

List feature flag statuses

cURL

curl --request GET \
  --url https://app.launchdarkly.com/api/v2/flag-statuses/{projectKey}/{environmentKey} \
  --header 'Authorization: <api-key>'

200

{
  "_links": {
    "self": {
      "href": "/api/v2/flag-statuses/my-project/my-environment",
      "type": "application/json"
    }
  },
  "items": [
    {
      "name": "inactive",
      "_links": {
        "parent": {
          "href": "/api/v2/flags/my-project/my-flag",
          "type": "application/json"
        },
        "self": {
          "href": "/api/v2/flag-statuses/my-project/my-flag",
          "type": "application/json"
        }
      },
      "lastRequested": "2020-02-05T18:17:01.514Z",
      "default": "<unknown>"
    }
  ]
}

Authorizations

Authorization · string · header · required

Path Parameters

projectKey · string<string> · required

The project key

environmentKey · string<string> · required

The environment key

Response

200

application/json

Flag Statuses collection response

_links · object · required

Show child attributes

Example:

{
  "self": {
    "href": "/api/v2/flag-statuses/my-project/my-environment",
    "type": "application/json"
  }
}

items · object[]

Show child attributes