v7

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-013764062.2 MB

Events

Search for events

Allows searching for events that match the query parameter criteria.

get/api/admin/search/events

Query parameters

querystring

Example:admin@example.com

Find events by a free-text search query. The query will be matched against the event data payload (if any).

idstring

Example:IS:123

Filter by event ID using supported operators: IS, IS_ANY_OF.

groupIdstring

Example:IS:123

Filter by group ID using supported operators: IS, IS_ANY_OF.

featurestring

Example:IS:myfeature

Filter by feature name using supported operators: IS, IS_ANY_OF

projectstring

Example:IS:default

Filter by projects ID using supported operators: IS, IS_ANY_OF.

typestring

Example:IS:change-added

Filter by event type using supported operators: IS, IS_ANY_OF.

createdBystring

Example:IS:2

Filter by the ID of the event creator, using supported operators: IS, IS_ANY_OF.

fromstring

Example:IS:2024-01-01

The starting date of the creation date range in IS:yyyy-MM-dd format

tostring

Example:IS:2024-01-31

The ending date of the creation date range in IS:yyyy-MM-dd format

offsetstring

Example:50

The number of features to skip when returning a page. By default it is set to 0.

limitstring

Example:50

The number of feature environments to return in a page. By default it is set to 50. The maximum is 1000.

environmentstring

Example:IS:production

Filter by environment name using supported operators: IS, IS_ANY_OF.

Response

eventSearchResponseSchema

totalinteger required

The total count of events

Example response

{
  "events": [
    {
      "createdAt": "2023-07-05T12:56:00.000Z",
      "type": "feature-created",
      "createdBy": "johndoe",
      "createdByUserId": 1337,
      "environment": "development",
      "project": "default",
      "featureName": "my.first.feature",
      "data": {
        "name": "new-feature",
        "description": "Flag description",
        "type": "release",
        "project": "my-project",
        "stale": false,
        "variants": [],
        "createdAt": "2022-05-31T13:32:20.547Z",
        "lastSeenAt": null,
        "impressionData": true
      },
      "preData": {
        "name": "new-feature",
        "description": "Flag description",
        "type": "release",
        "project": "my-project",
        "stale": false,
        "variants": [],
        "createdAt": "2022-05-31T13:32:20.547Z",
        "lastSeenAt": null,
        "impressionData": true
      },
      "tags": [
        {
          "value": "a-tag-value",
          "type": "simple",
          "color": "#FFFFFF"
        }
      ],
      "ip": "192.168.1.1",
      "groupType": "change-request",
      "groupId": "01HQVX5K8P9EXAMPLE123456"
    }
  ],
  "total": 842
}