Skip to main content
Retrieve logs of messages that were released to recipients, including information about the user who processed the release. These logs also capture messages that expired while in the held queue and were subsequently discarded by Mimecast’s housekeeping services. Required application permissions: Monitoring | Held | Read. Note: You must provide at least one parameter to execute the action.
External DocumentationTo learn more, visit the Mimecast documentation.

​
Basic Parameters

ParameterDescription
Search By End DateThe end date of results to search by. The default value is the current date.
Search By Start DateThe start date of results to search by. The default value id the start on the current day.
Search FieldThe field to be searched.
Search ValueThe value on which the search will be applied.

​
Advanced Parameters

ParameterDescription
Filter By FieldField Filter that is applied to the search results.
Filter By Field ValueThe value of which the filter will be applied, depends on the Field chosen in the Filter By Field parameter.

Must be provided if Filter By Field is provided.

* Value options for route field: all, internal, outbound, inbound.
* Value options for status field: released, rejected.
* Value options for attachments field: true, false.

​
Example Output

{
	"data": [
		{
			"heldReleaseLogs": [
				{
					"attachments": true,
					"detectionLevel": "relaxed",
					"fromEnv": {
						"address": "string",
						"domain": "string"
					},
					"fromHdr": {
						"address": "string",
						"domain": "string"
					},
					"heldGroup": "string",
					"heldReason": "string",
					"id": "string",
					"messageInfo": "string",
					"operator": {
						"email": "string"
					},
					"policy": "string",
					"rejectReason": "string",
					"released": "yyyy-MM-dd'T'HH:mm:ssZ",
					"route": "inbound",
					"size": 1024,
					"spamProcessingDetail": {
						"dkim": {
							"allow": true,
							"info": "string"
						},
						"dmarc": {
							"allow": true,
							"info": "string"
						},
						"greyEmail": true,
						"managedSender": {
							"allow": true,
							"info": "string"
						},
						"permittedSender": {
							"allow": true,
							"info": "string"
						},
						"rbl": {
							"allow": true,
							"info": "string"
						},
						"spf": {
							"allow": true,
							"info": "string"
						}
					},
					"verdict": {
						"spamScore": 10,
						"status": "released"
					},
					"subject": "string",
					"to": [
						{
							"displayableName": "string",
							"emailAddress": "string"
						}
					]
				}
			]
		}
	],
	"fail": [
		{
			"errors": [
				{
					"code": "string",
					"message": "string",
					"retryable": true
				}
			],
			"key": {
				"end": "yyyy-MM-dd'T'HH:mm:ssZ",
				"filterBy": [
					{
						"fieldName": "string",
						"value": "string"
					}
				],
				"searchBy": {
					"fieldName": "string",
					"value": "string"
				},
				"start": "yyyy-MM-dd'T'HH:mm:ssZ"
			}
		}
	]
}

​
Workflow Library Example

Message Release Logs with Mimecast and Send Results Via Email
Workflow LibraryPreview this Workflow on desktop