> ## 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.

# Search Messages

Search all messages.

Required application permissions: `Gateway | Tracking | Read`.

> [!NOTE]
>
> External Documentation
>
> To learn more, visit the [Mimecast documentation](https://developer.services.mimecast.com/docs/cloudgateway/1/routes/api/message-finder/search/post).

## Basic Parameters

| Parameter | Description |
| - | - |
| Message Route | Filter by the route of the message. |
| Sender | The Email address or domain of the sender of the Email. |
| Status | Filter by the status of the email. |

## Advanced Parameters

| Parameter | Description |
| - | - |
| End Time | Time of the most recent message to be returned. |
| Includes Attachments | Search emails that include attachments. |
| Message ID | The ID of the message to return. |
| Receiver | The Email address or domain of the receiver of the Email. |
| Search Reason | Reason for the search, used mainly for tracking purposes. |
| Sender IP | The IP of the sender of the Email. |
| Start Time | Time of the earliest message to be returned. |
| Subject | The Subject of the Email. |
| URL | A URL that is contained in the returned Emails. |

## Example Output

```json theme={"dark"}
{
	"fail": [],
	"meta": {
		"status": 200
	},
	"data": [
		{
			"attachments": false,
			"detectionLevel": "string",
			"fromEnv": {},
			"fromHdr": {},
			"id": "string",
			"info": "string",
			"received": "string",
			"route": "string",
			"senderIP": "string",
			"sent": "string",
			"spamScore": "string",
			"spamScore": 1,
			"status": "string",
			"subject": "string",
			"to": [
				"string"
			]
		}
	]
}
```