Usage report: email activity and mailbox usage across periods.

Compares D7, D30, and D90 activity counts plus mailbox storage usage — useful for adoption tracking, cleanup planning, and audit reporting.

Permissions

Requires delegated permission Reports.Read.All.

Reference

• https://learn.microsoft.com/en-us/graph/api/reportroot-getemailactivitycounts
• https://learn.microsoft.com/en-us/graph/api/reportroot-getmailboxusagestorage
• https://learn.microsoft.com/en-us/graph/api/reportroot-getmailboxusagemailboxcounts

View source

from office365.graph_client import GraphClient
from tests.settings import client_id, password, tenant, username

client = GraphClient(tenant=tenant).with_username_and_password(client_id, username, password)

PERIODS = ["D7", "D30", "D90"]

print("Email activity report\n")

for p in PERIODS:
    counts = client.reports.get_email_activity_counts(p).execute_query()
    print(f"  Activity counts ({p}): {counts.value}")

print()

storage = client.reports.get_mailbox_usage_storage("D90").execute_query()
print(f"  Mailbox storage (D90): {storage.value}")

mailbox_counts = client.reports.get_mailbox_usage_mailbox_counts("D90").execute_query()
print(f"  Mailbox counts (D90): {mailbox_counts.value}")

---

← Back to Reports