Every thread in one inbox, newest activity first, with its messages. Keyset pagination: pass the previous page's next_cursor as cursor until next_cursor is null. A page can hold fewer than limit threads, even none, and still have a next_cursor. There is no date filter: to sync, walk the whole inbox (see the guide). A thread that gets new activity mid-walk moves to the front, so the next walk picks it up.

Unsent drafts and scheduled sends are never returned: threads holding only those are skipped. Subjects, snippets, attachment file names and ids, and to-do summaries need mail.content.read.

Scope: mail.metadata.read. Rate limit class: read (600/minute per key).