---
title: "List Events"
method: GET
path: "/eventmanagement/{version}/events"
tags: ["Events"]
---

# List Events

`GET /eventmanagement/{version}/events`

## Request

- Base URL: `https://apis.druva.com/platform`
- URL: `https://apis.druva.com/platform/eventmanagement/{version}/events`
- Auth: API key in header `Authorization`

This API returns a list of events based on pageToken or filters.
<br>You can query using the pageToken or filters; you cannot provide both simultaneously.
<br>When using the pageToken parameter, the initial request should not include any pageToken value. The response will contain a list of events and a nextPageToken. For subsequent API calls, include the pageToken parameter with the value of nextPageToken received from the previous API response. This ensures that you retrieve the next page of events.
<br>For example
  <br> /events?pageToken=qwwzsx1qwer0efjdvfhuvuvvuvu
  <br> /events?pageSize=150&productID=12289&syslogSeverity=5

## Path parameters

- `version` 'v1' | 'v2' | 'v3', required

## Query parameters

- `pageToken` string
- `pageSize` integer
- `productID` integer
- `category` string
- `type` string
- `feature` string
- `syslogSeverity` integer

## Response `200`

Success

- union
  - ListEventsResponse
    - `events` EventResponse[]
      - `category` string: category represents one of the [EVENT, ALERT, AUDIT].
      - `details` string: details represents the product specific event details.
      - `feature` string: feature represents the feature by which event was generated.
      - `globalID` string: globalID represents the global ID of the customer or global ID of theMSP.
      - `timeStamp` integer: Time at which event occurred.
      - `productID` integer: productID represents the id of the product that generated the event.
      - `syslogFacility` integer: Fixed values based on event source category.
      - `syslogSeverity` integer: syslogSeverity represents the severity(0-7) of the event. <br>For Emergency 0 <br>For Alert (action must be taken immediately) 1 <br>For Critical (critical conditions) 2 <br>For Error (error conditions) 3 <br>For Warning (warning conditions) 4 <br>For Notice (normal but significant condition) 5 <br>For Informational (informational messages) 6 <br>For Debug (debug-level messages) 7
      - `type` string: type represents the type of the event e.g - Login,Logout,LicenseExpired,BackupStatus etc.
  - ListEventsResponseTwo
    - `events` EventResponseTwo[]
      - `category` string: category represents one of the [EVENT, ALERT, AUDIT].
      - `details` object: details represents the product specific event details. For more information on events that DCP publishes, see [Druva Cloud Platform events](/reference/druva-cloud-platform-events).
      - `feature` string: feature represents the feature by which event was generated.
      - `globalID` string: globalID represents the global ID of the customer or global ID of theMSP.
      - `timeStamp` integer: Time at which event occurred.
      - `productID` integer: productID represents the id of the product that generated the event.
      - `syslogFacility` integer: Fixed values based on event source category.
      - `syslogSeverity` integer: syslogSeverity represents the severity(0-7) of the event. <br>For Emergency 0 <br>For Alert (action must be taken immediately) 1 <br>For Critical (critical conditions) 2 <br>For Error (error conditions) 3 <br>For Warning (warning conditions) 4 <br>For Notice (normal but significant condition) 5 <br>For Informational (informational messages) 6 <br>For Debug (debug-level messages) 7
      - `type` string: type represents the type of the event e.g - Login,Logout,LicenseExpired,BackupStatus etc.
  - ListEventsResponseThree
    - `events` EventResponseThree[]
      - `category` string: category represents one of the [EVENT, ALERT, AUDIT].
      - `details` object: details represents the product specific event details. For more information on events that DCP publishes, see [Druva Cloud Platform events](/reference/druva-cloud-platform-events-v3).
      - `feature` string: feature represents the feature by which event was generated.
      - `globalID` string: globalID represents the global ID of the customer or global ID of theMSP.
      - `timeStamp` integer: Time at which event occurred.
      - `productID` integer: productID represents the id of the product that generated the event.
      - `syslogFacility` integer: Fixed values based on event source category.
      - `syslogSeverity` integer: syslogSeverity represents the severity(0-7) of the event. <br>For Emergency 0 <br>For Alert (action must be taken immediately) 1 <br>For Critical (critical conditions) 2 <br>For Error (error conditions) 3 <br>For Warning (warning conditions) 4 <br>For Notice (normal but significant condition) 5 <br>For Informational (informational messages) 6 <br>For Debug (debug-level messages) 7
      - `type` string: type represents the type of the event e.g - Login,Logout,LicenseExpired,BackupStatus etc.

## Other responses

- `400`: Bad Request
- `404`: The requested resource was not found.
- `500`: The request was not processed due to an internal error.

---

[API](https://skmtc.dev/druva/apis/platform.md) - [All operations](https://skmtc.dev/druva/apis/platform/llms.txt) - [OpenAPI document](https://skmtc.dev/druva/apis/platform/revisions/80533a559af4?raw)
