List retained threads
GET/api/threads
x-audience: "management"
x-required-scope: "messages:read"
Lists account-scoped retained conversations, 25 groups per page, sorted by latest receipt descending with a stable ID tie-breaker. q and status match a retained member, including older members. Counts and latestMessage describe the complete retained thread. Search is a literal case-insensitive substring across sender, routed recipient, subject, Message-ID, receipt ID, event ID and thread ID. Combined filters must match the same member. Unthreaded messages appear individually with threadId null. Zero-day retention returns an empty list. Expired delivery audits are accessible through individual messages, not threads.
Request
Responses
- 200
- 401
- 403
- 429
- 503
Success
Missing, invalid or revoked credentials.
Required scope or account access missing.
Shared client-IP or account request allowance exhausted. Retry after the indicated number of seconds. Browser authentication errors can use a different response format.
Response Headers
no-store
Seconds to wait before retrying.
Request limiting cannot be enforced. Retry later with backoff.
Response Headers
no-store