Skip to content

Google: Lists the threads in the user's mailbox For more information, see Manage threads (https: developers google com workspace gmail api guides threads) — response body

Lists the threads in the user's mailbox. For more information, see [Manage threads](https://developers.google.com/workspace/gmail/api/guides/threads).: response body. Complete fields and constraints for contract 2026-10-27.

API reference · Contract 2026-10-27

SDK schema: Lists the threads in the user's mailbox For more information, see Manage threads (https: developers google com workspace gmail api guides threads) — response body

FieldTypePresenceDescription and constraints
$objectRoot
nextPageTokenstringOptionalPage token to retrieve the next page of results in the list.
resultSizeEstimateJSONOptional
resultSizeEstimate (anyOf 1)integerAlternativeEstimated total number of results.
Format: uint32
resultSizeEstimate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
threadsarrayOptionalList of threads. Note that each thread resource does not contain a list of `messages`. The list of `messages` for a given thread can be fetched using the [`threads.get`](https://developers.google.com/workspace/gmail/api/v1/reference/users/threads/get) method.
threads[]ModelEach itemExpand Gets the specified thread For more information, see Manage threads (https: developers google com workspace gmail api guides threads) — response body

Referenced models: Gets the specified thread For more information, see Manage threads (https: developers google com workspace gmail api guides threads) — response body

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.