Opaque cursor from a previous response to fetch the next page

Maximum number of items to return per page (1–100, default 20)

Filter emails by agent ID

Only return received (INBOUND) or sent (OUTBOUND) email

Only return email in this thread (see GET /threads)

Only return email whose sender address matches this value (case-insensitive, exact address match)

Only return email addressed to this recipient (case-insensitive). Matches if the address appears anywhere in the message's recipient list, not only as the first recipient.

Only return email created strictly after this ISO-8601 timestamp

Only return email created strictly before this ISO-8601 timestamp

Include messages classified as spam on arrival. They are excluded by default. Naming spam in labels also counts as asking for it, so a deliberate spam query is never silently emptied by this default.

Include messages carrying the archived label. They are excluded by default, so archiving actually removes mail from a listing rather than only tagging it. Naming archived in labels also counts as asking for it (and returns ONLY archived mail); use this flag instead to see archived mail mixed in with the rest.