List messages sent to one recipient (PII-gated)
Returns one cursor-paginated page of messages addressed to a specific
recipient — the same shape as listMessages, but with the recipient
pinned from the URL path. This route is gated solely on the
analytics.search.recipients scope (the broader messages.view is
not required) so you can grant audit-style recipient lookup without
exposing the full message index.
Match is case-sensitive on the stored recipient address. URL-encode
@ as %40 (e.g. user%40example.com). Unknown recipients return
200 with data: [] — never 404. Same 30-day default window and
plan-retention behavior as listMessages.
Path parameters
email string<email> required Recipient address. Percent-encode @ as %40.
Query parameters
limit integer optional Page size (1–200). Default 50.
cursor string optional Opaque cursor returned from the previous page.
from string<date-time> optional Window start (RFC 3339). Defaults to 30 days ago.
to string<date-time> optional Window end (RFC 3339). Defaults to now.
Responses
code is internal_error. The
request_id field can be quoted to SendOps support to investigate.
application/problem+json