---
title: "List flag events"
method: GET
path: "/api/v2/engineering-insights/flag-events"
tags: ["Insights flag events (beta)"]
---

# List flag events

`GET /api/v2/engineering-insights/flag-events`

Get a list of flag events

### Expanding the flag event collection response

LaunchDarkly supports expanding the flag event collection response to include additional fields.

To expand the response, append the `expand` query parameter and include the following:

* `experiments` includes details on all of the experiments run on each flag

For example, use `?expand=experiments` to include the `experiments` field in the response. By default, this field is **not** included in the response.

## Query parameters

- `projectKey` string, string, required — The project key
- `environmentKey` string, string, required — The environment key
- `applicationKey` string, string — Comma separated list of application keys
- `query` string, string — Filter events by flag key
- `impactSize` string, string — Filter events by impact size. A small impact created a less than 20% change in the proportion of end users receiving one or more flag variations. A medium impact created between a 20%-80% change. A large impact created a more than 80% change. Options: `none`, `small`, `medium`, `large`
- `hasExperiments` boolean — Filter events to those associated with an experiment (`true`) or without an experiment (`false`)
- `global` string, string — Filter to include or exclude global events. Default value is `include`. Options: `include`, `exclude`
- `expand` string, string — Expand properties in response. Options: `experiments`
- `limit` integer — The number of deployments to return. Default is 20. Maximum allowed is 100.
- `from` integer — Unix timestamp in milliseconds. Default value is 7 days ago.
- `to` integer — Unix timestamp in milliseconds. Default value is now.
- `after` string, string — Identifier used for pagination
- `before` string, string — Identifier used for pagination

## Response `200`

Flag event collection response

- FlagEventCollectionRep
  - `totalCount` integer, required — The total number of flag events
  - `items` FlagEventRep[], required — A list of flag events
    - `id` string, uuid, required — The flag event ID
    - `projectId` string, required — The project ID
    - `projectKey` string, required — The project key
    - `environmentId` string — The environment ID
    - `environmentKey` string — The environment key
    - `flagKey` string, required — The flag key
    - `eventType` string, required
    - `eventTime` integer, required
    - `description` string, required — The event description
    - `auditLogEntryId` string — The audit log entry ID
    - `member` FlagEventMemberRep
      - `id` string, required — The member ID
      - `email` string, required — The member email
      - `firstName` string, required — The member first name
      - `lastName` string, required — The member last name
    - `actions` string[] — The resource actions
    - `impact` FlagEventImpactRep, required
      - `size` 'none' | 'small' | 'medium' | 'large' — The size of the flag event impact. Sizes are defined as: none (0%), small (0-20%), medium (20-80%), large (>80%)
      - `percentage` number — The percentage of the flag event impact
      - `reason` string
      - `evaluationsSummary` EvaluationsSummary
        - `variations` VariationEvalSummary[] — A list of variation evaluations
          - `value` string — The variation value
          - `before` integer — The number of evaluations in the ten minutes before the flag event
          - `after` integer — The number of evaluations in the ten minutes after the flag event
    - `experiments` FlagEventExperimentCollection
      - `totalCount` integer, required — The total number of experiments
      - `items` FlagEventExperiment[], required — A list of experiments
        - `key` string, required — The experiment key
        - `name` string, required — The experiment name
        - `iteration` FlagEventExperimentIteration, required
          - `id` string, required — The experiment iteration ID
          - `status` string, required
          - `startedAt` integer, required
          - `endedAt` integer
          - `_links` object — The location and content type of related resources
        - `_links` object — The location and content type of related resources
  - `_links` object — The location and content type of related resources

## Other responses

- `400` — Invalid request
- `401` — Invalid access token
- `403` — Forbidden
- `404` — Invalid resource identifier
- `429` — Rate limited

---

[API](https://skmtc.dev/launchdarkly/apis/launchdarkly-rest-api.md) · [All operations](https://skmtc.dev/launchdarkly/apis/launchdarkly-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/launchdarkly/launchdarkly-rest-api/revisions/69c5c9aafe78/schema)