> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Events

Retrieve a list of events.

**Required Permission**:

* `cyera.read.event`

<Note>
  External Documentation

  To learn more, visit the [Cyera documentation](https://api.cyera.io/docs#tag/events/get/v1/events).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter         | Description                                                                                               |
  | ----------------- | --------------------------------------------------------------------------------------------------------- |
  | Datastore UIDs    | A comma-separated list of datastore UIDs to filter events by.                                             |
  | Event Categories  | Retrieve events belonging to the selected categories.                                                     |
  | Event Date After  | Retrieve events which occurred on or after the specified timestamp.                                       |
  | Event Date Before | Retrieve events which occurred on or before the specified timestamp.                                      |
  | Event Types       | A comma-separated list of event types to filter events by.                                                |
  | Issue UIDs        | A comma-separated list of issue UIDs to filter events by. Can be obtained using the `List Issues` action. |
  | Limit             | The maximum number of events to retrieve in the result. Valid range is `1-100`.                           |
  | Offset            | The pagination offset indicating the starting point for the next set of results.                          |
  | Return All Pages  | Automatically fetch all resources, page by page.                                                          |
</div>

## Example Output

```json theme={"dark"}
{
	"limit": 10,
	"offset": 0,
	"results": [
		{
			"account": {
				"name": "string",
				"platform": "string",
				"uid": "string"
			},
			"affectedDataClassAppearances": {
				"dataClass": {
					"classificationName": "string",
					"uid": "string"
				},
				"recordsCount": 0
			},
			"affectedObjectsCount": 0,
			"affectedObjectsDiff": 0,
			"affectedRecordsDiff": 0,
			"automaticScanning": {},
			"changedClassificationUid": {},
			"classificationName": "string",
			"classifications": [
				{
					"classificationName": "string",
					"uid": "string"
				}
			],
			"cloudProvider": "string",
			"datastore": {
				"dataOwner": {},
				"infrastructure": "string",
				"name": {},
				"recordsAtHighRisk": 0,
				"uid": "string",
				"userTags": {},
				"vpcId": {}
			},
			"datastoreUserTags": [
				"string"
			],
			"date": "date-time",
			"deploymentName": "string",
			"domainName": "string",
			"endState": "string",
			"expectedM365SensitivityLabelAssignmentsCount": 0,
			"failedM365SensitivityLabelAssignmentsCount": 0,
			"frequency": "string",
			"inPlatformIdentifier": "string",
			"isDomainTrusted": false,
			"isReportDeleted": false,
			"isReportExpired": false,
			"issue": {
				"policy": {
					"name": "string",
					"uid": "string",
					"useCases": [
						"string"
					]
				},
				"resolution": "string",
				"resolutionNote": "string",
				"riskStatus": "string",
				"uid": "string"
			},
			"issueName": "string",
			"issueUid": "string",
			"issues": [
				{
					"policy": {
						"name": "string",
						"uid": "string",
						"useCases": [
							"string"
						]
					},
					"resolution": "string",
					"resolutionNote": "string",
					"riskStatus": "string",
					"uid": "string"
				}
			],
			"m365AssignedSensitivityLabelName": "string",
			"originalSensitivity": "string",
			"originalSensitivityDisplayName": "string",
			"policy": {
				"name": "string",
				"uid": "string",
				"useCases": [
					"string"
				]
			},
			"projectName": "string",
			"projectUid": "string",
			"recipients": [
				"string"
			],
			"reportFileName": "string",
			"reportInstanceUid": "string",
			"reportJobUid": "string",
			"reportName": "string",
			"reportType": "string",
			"sku": "string",
			"sourceClassifications": [
				{
					"classificationName": "string",
					"uid": "string"
				}
			],
			"stateDetails": {},
			"subscriptionUid": "string",
			"successfulM365SensitivityLabelAssignmentsCount": 0,
			"targetClassifications": [
				{
					"classificationName": "string",
					"uid": "string"
				}
			],
			"targetSensitivity": "string",
			"targetSensitivityDisplayName": "string",
			"triggerReason": {},
			"type": "string",
			"uid": "string",
			"user": "string",
			"vendorLink": "string",
			"vendorStatus": "string",
			"vendorTicketId": "string"
		}
	],
	"total": 1
}
```

## Workflow Library Example

[List Events with Cyera and Send Results Via Email](https://library.blinkops.com/workflows/list-events-with-cyera-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/list-events-with-cyera-and-send-results-via-email/canvas" />
</div>