ExchangeMessageTrace.Read.All

Allows the app to search the email message trace on behalf of the signed-in user.

Merill's Note

For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the ExchangeMessageTrace.Read.All permission.

If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the Export-MsIdAppConsentGrantReport command. See How To: Run a quick OAuth app audit of your tenant

Category	Application	Delegated
Identifier	89b20d8a-76e2-4057-867b-9961f800b9a4	b2e7d27e-14e7-41ad-bb15-a88ceb9c3e90
DisplayText	Search the email message trace	Search the email message trace
Description	Allows the app to search the email message trace, without a signed-in user.	Allows the app to search the email message trace on behalf of the signed-in user.
AdminConsentRequired	Yes	Yes

Graph Methods

• API [v1.0]
• API [beta]
• PowerShell [v1.0]
• PowerShell [beta]

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	GET /admin/exchange/tracing/messageTraces
	GET /admin/exchange/tracing/messageTraces/{exchangeMessageTraceId}/getDetailsByRecipient(recipientAddress='parameterValue')

Resources

Granting this permission allows the calling application to access (and/or update) the following information in your tenant.

• exchangeMessageTrace
• exchangeMessageTraceDetail

Graph reference: exchangeMessageTrace

Property	Type	Description
fromIP	String	The source IP address. For incoming messages, this value is the public IP address of the SMTP email server that sent the message. Supports $filter (eq).
id	String	The unique identifier for the message trace. Supports $filter (eq).
messageId	String	The Message-ID header field of the message. The format of the Message-ID depends on the messaging server that sent the message. Supports $filter (eq).
receivedDateTime	DateTimeOffset	The date and time when the message was received by Exchange Online. The timestamp is in UTC format. Supports $filter (ge, le).
recipientAddress	String	The SMTP email address of the user that the message was addressed to. Supports $filter (eq).
senderAddress	String	The SMTP email address of the user the message was purportedly from. Supports $filter (eq).
size	Int32	The size of the message in bytes.
status	exchangeMessageTraceStatus	The delivery status of the message. The possible values are: gettingStatus, pending, failed, delivered, expanded, quarantined, filteredAsSpam, unknownFutureValue. Supports $filter (eq).
subject	String	The subject line of the message. Supports $filter (contains, startsWith, endsWith).
toIP	String	The destination IP address. For outgoing messages, this value is the public IP address in the resolved MX record for the destination domain. For incoming messages to Exchange Online, this value is blank. Supports $filter (eq).