List Threads
Retrieve the threads in an inbox, filtered by folder, label, and read status.
GET
A thread is a conversation within an inbox, made up of one or more messages.
To find threads by text, sender, recipient, attachment, or date, use Search
Threads.
Path Parameters
Query Parameters
string
Comma-separated folders to list.
inbox: The default. The thread holds at least one received message.archive: The thread was archived.spam: The thread was marked as spam.trash: The thread is scheduled for deletion in 30 days.sent: Threads whose messages are all outbound.
string
Comma-separated label IDs.
boolean
true returns threads where every email is read. false returns threads with
at least one unread email.number
Number of threads to return. Default is
20, maximum is 100, minimum is
1.string
The ID of the last thread on the current page. Returns the next, older page.
Must be a thread ID. To filter by date, use Search
Threads with
start_date.string
The ID of the first thread on the current page. Returns the previous, newer
page. Cannot be combined with
after. Must be a thread ID. To filter by date,
use Search Threads with end_date.Response Fields
string
Always
list.boolean
Whether more threads exist beyond this page. Pass the last thread’s
id as
after to continue.array
The matching threads, most recently active first.