messages
Get one message
GET /v1/messages/{id}
Auth required
messages.view
Returns the aggregated detail for a single message (the same
V1Message projection as the list endpoint). Lookup is by the
SES-issued message id, not an internal UUID. Cross-org lookups and
unknown ids both return 404 not_found — no information leak about
whether a message exists in another org. Detail lookups go further
back than your plan's analytics-retention window: up to 365 days of
message detail is kept regardless of plan tier. Very old ids will
eventually 404 once they fall outside that window.
Path parameters
id string required SES message id (the SES-issued string, not a UUID).
Responses
200 Single-message detail application/json
401 Missing, malformed, or unknown API key application/problem+json
403 Key lacks the required scope or plan limit violated application/problem+json
404 Resource not found application/problem+json
429 Per-org rate limit exceeded application/problem+json
500 Unexpected server-side failure. The
code is internal_error. The
request_id field can be quoted to SendOps support to investigate.
application/problem+json