List Audit Events

Return audit events that match the provided parameters.

Required application permissions: Account | Logs | Read.

External Documentation

To learn more, visit the Mimecast documentation.

​

Parameters

Parameter	Description
Query Events	Search audit events by providing a search query.
Search By Categories	A comma separated or JSON list of audit category types to search by. Can be obtained using the Get Categories action, specifically from the code field in the response.
Search By End Time	The events’ end date to search by.
Search By Start Date	The events’ start date to search by. Historical lookup is restricted to last 60 days.

​

Example Output

{
	"data": [
		{
			"auditType": "string",
			"category": "string",
			"eventInfo": "string",
			"eventTime": "yyyy-MM-dd'T'HH:mm:ssZ",
			"id": "string"
		}
	],
	"fail": [
		{
			"errors": [
				{
					"code": "string",
					"message": "string",
					"retryable": true
				}
			],
			"key": {
				"categories": [
					{
						"endDateTime": "yyyy-MM-dd'T'HH:mm:ssZ",
						"query": "string",
						"startDateTime": "yyyy-MM-dd'T'HH:mm:ssZ"
					}
				]
			}
		}
	]
}