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

# Export feature flag change history

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

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/feature-flags/history/export`
- 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`

Exports the organization's feature flag change events as a CSV file, newest first, without pagination.
It accepts the same filters as the List feature flag change history endpoint, and its columns match the CSV export on the flag history page:
Flag Version, Flag Name, Flag Key, Flag UUID, Action, User Name, User Email, User Type, Environment, and Timestamp.

If an export fails before the file starts, the response is a JSON:API error. Large exports stream as they are read.
If an export fails after streaming starts, the connection closes before the file ends, so the download fails instead of
returning a file with missing rows. An export must finish within the 60-second request timeout. If an export times out,
narrow the date range.

## 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

## Response `200`

OK

## 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/export/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)
