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

# List feature flag change history

`GET /api/v2/feature-flags/history`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/feature-flags/history`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `feature_flag_config_read`

Returns the organization's feature flag change events, newest first.
Each event includes a readable description of the change.
All filters are optional, and events must match every filter you set. Without a date range, the whole history is listed.
Results are paginated with `page[limit]` and `page[offset]`; follow `links.next` to read further back.

## Query parameters

- `start_date` string, date-time
- `end_date` string, date-time
- `teams` string[]
- `tags` string[]
- `feature_flag_id` string, uuid
- `environment_id` string, uuid
- `include_suggestion_events` boolean
- `page[limit]` integer
- `page[offset]` integer

## Response `200`

OK

- ListFeatureFlagHistoryResponse: Response containing feature flag change events, newest first.
  - `data` FeatureFlagChangeEvent[], required: The change events.
    - `attributes` FeatureFlagChangeEventAttributes, required: Attributes of a feature flag change event.
      - `action` 'created' | 'updated' | 'deleted' | 'archived' | 'unarchived' | 'scheduled' | 'started' | 'paused' | 'unpaused' | 'stopped', required: The kind of change.
      - `change_metadata` string, nullable: Additional details about the change, as a JSON-encoded string.
      - `creation_source` 'UI' | 'MCP', nullable: Where the change was made: `UI` for the Datadog app, or `MCP` for a Model Context Protocol (MCP) client.
      - `description` string: A readable sentence describing the change, as shown on the flag history page and in the Action column of the CSV export.
      - `environment` FeatureFlagChangeEventEnvironment, nullable: The environment the change applies to. Null for a change to the flag itself rather than to one environment.
        - `id` string, uuid, required: The ID of the environment.
        - `is_production` boolean, required: Whether the environment is a production environment.
        - `name` string, required: The name of the environment.
      - `feature_flag` FeatureFlagChangeEventFlag, required: The feature flag the change applies to.
        - `id` string, uuid, required: The ID of the feature flag.
        - `key` string, required: The key of the feature flag.
        - `name` string, required: The name of the feature flag.
      - `new_value` string, nullable: The value after the change, serialized as a string.
      - `previous_value` string, nullable: The value before the change, serialized as a string.
      - `property` 'FLAG' | 'FLAG_NAME' | 'FLAG_DESCRIPTION' | 'JSON_SCHEMA' | 'DISTRIBUTION_CHANNEL' | 'REQUIRE_APPROVAL' | 'VARIANT' | 'VARIANT_NAME' | 'VARIANT_VALUE' | 'ALLOCATIONS' | 'ROLLOUT' | 'ENVIRONMENT_STATUS' | 'DEFAULT_VARIANT' | 'OVERRIDE_VARIANT' | 'STALENESS_STATUS' | 'SAVED_FILTER', required: The part of the feature flag the change applies to.
      - `suggestion_review` FeatureFlagChangeEventSuggestionReview: Review details of a change request that needed approval. Present on review events, which `include_suggestion_events` adds. Also present on a change that an approved change request applied, even when `include_suggestion_events` is `false`.
        - `lifecycle_status` 'pending' | 'approved' | 'applied' | 'rejected' | 'discarded', required: Where the change request is in its lifecycle.
        - `requester_comment` string: The comment left by the person who requested the change.
        - `reviewer_comment` string: The comment left by the reviewer.
        - `status` 'pending' | 'approved' | 'rejected', required: The review status of the change request.
        - `suggestion_created_by` string: The ID of the user who requested the change.
      - `timestamp` string, date-time, required: When the change was made.
      - `user_id` string, nullable: The ID of the user who made the change. Null when no user made the change.
      - `version_number` integer, required: The version of the feature flag the change produced.
    - `id` string, uuid, required: The ID of the change event.
    - `type` 'change-events', required: The resource type.
  - `links` FeatureFlagsPaginationLinks: 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.
    - `first` string: Link to the first page.
    - `last` string: Link to the last page.
    - `next` string: Link to the next page, when available.
    - `prev` string: Link to the previous page, when available.
    - `self` string: Link to the current page.
  - `meta` FeatureFlagHistoryPaginationMeta: Pagination metadata for feature flag change history.
    - `page` FeatureFlagHistoryPaginationMetaPage: Pagination metadata for feature flag change history responses.
      - `first_offset` integer: Offset of the first page.
      - `last_offset` integer, nullable: Offset of the last page.
      - `limit` integer: Maximum number of events returned on this page.
      - `next_offset` integer, nullable: Offset of the next page, or null when there is no next page.
      - `offset` integer: Number of matching events skipped before this page.
      - `prev_offset` integer, nullable: Offset of the previous page, or null when there is no previous page.
      - `total` integer: Total number of events matching the filters, independent of the page size. It counts experiment proposals that you cannot read, which are left out of the pages, so a page can hold fewer events than `limit`.
      - `type` string: The pagination method. Always `offset_limit`.

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `429`: Too many requests

## Changes

- **2026-11-12** `6cc2bb1f7a80`: 2 info
  - added the optional property `errors/items/code` to the response with the `400` status
  - added the optional property `errors/items/code` to the response with the `403` status
- **2026-11-11** `eee0cf528e5d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/changes/api/v2/feature-flags/history/get.md)

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/14d85160bfa9?raw)
