Back to catalog

Gmail · Productivity

Gmail API / List threads

Lists thread ids in the mailbox (developers.google.com/gmail/api/reference/rest/v1/users.threads/list): q, maxResults, labelIds and pageToken are the query fields the docs define.

Private Gateway connection

Data below comes from the configured private Gateway. Provider activation remains governed by its evidence and policy gates.

unverifiedRequest shape unavailableUnverified
Published API evidence
Public metadata only. Response bodies, credentials, and internal review notes are never displayed.

No verification date is claimed. No response capture is claimed.

Request parameters

  • labelIds query · optional

    Only return threads with all of the specified label ids.

  • maxResults query · optional

    Max threads returned on one result page (Google default 100, max 500).

  • pageToken query · optional

    A pageToken from a previous call's nextPageToken.

  • q query · optional

    Gmail search query, same syntax as the Gmail search box.

Sign in to run this operation, inspect live eligibility, and see governed execution and audit evidence. Sign in.