Get the most recent events from the Unleash instance or all events related to a project.

Returns the last 100 events from the Unleash instance when called without a query parameter. When called with a project parameter, returns all events for the specified project.

If the provided project does not exist, the list of events will be empty.

get/api/admin/events

Query parameters

projectstring

The name of the project whose events you want to retrieve

Response

eventsSchema

version1 required

The api version of this response. A natural increasing number. Only increases if format changes

totalEventsinteger

The total count of events

Example response

{
  "version": 1,
  "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"
    }
  ],
  "totalEvents": 842
}

Changes

Changed in 2 of the 7 revisions of this API.5

Jul 31, 2026b2c3116e633e1See the full diff
- ●
  added the new safeguard-triggered enum value to the // response property for the response status
  response-property-enum-value-added
Jun 15, 2026774670258f044See the full diff
- ●
  added the new remote-mcp-server-settings-updated enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new user-access-request-approved enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new user-access-request-registered enum value to the // response property for the response status
  response-property-enum-value-added
- ●
  added the new user-access-request-rejected enum value to the // response property for the response status
  response-property-enum-value-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history