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

# List Events

`GET /eventmanagement/{version}/events`

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` object[], required
      - `id` integer — The unique id of the event in Druva Realize. For example - 20
      - `area` string — The part of the product from where the event generated. For example - Platform.
      - `category` string — The category of the product area from where the event generated. For example - Admin Event.
      - `type` string — The type of the generated event. This is usually an action that took place for that event category. For example - Admin Login.
      - `occurenceTime` integer — The epoch time when the event was generated. For example - 1610707530.
      - `syslogSeverity` integer — The severity level mentioned in the Sys Log. For example - 6.
      - `syslogFacility` integer — The facility code mentioned in the Sys Log. For example - 23.
      - `details` object — Specific details of the event and the source from where the event generated. These are generic.
        - `location` string
        - `adminName` string
        - `adminEmail` string
        - `loginResult` string
        - `adminActivity` string
        - `adminIPAddress` string
        - `adminLoginTime` string
    - `nextPageToken` string, required — The token to access the next page of results. This parameter will be empty for the last page of the results. For example - eyJpZCI6NTY1NX0=
  - 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.net/druva/apis/authentication.md) · [All operations](https://skmtc.net/druva/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/druva/authentication/revisions/2af2bf148b25/schema)