Skip to main content

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​

Success