Skip to content

Google: Lists the messages in the user's mailbox For more information, see List Gmail messages (https: developers google com workspace gmail api guides list-messages) — response body

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

API reference · Contract 2026-10-27

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

FieldTypePresenceDescription and constraints
$objectRoot
messagesarrayOptionalList of messages. Note that each message resource contains only an `id` and a `threadId`. Additional message details can be fetched using the messages.get method.
messages[]ModelEach itemExpand Gets the specified message — response body
nextPageTokenstringOptionalToken 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]+)?$

Referenced models: Gets the specified message — 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.