> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r28.ai/charter/llms.txt
> Use this file to discover all available pages before exploring further.

# messages_get

> Read one message, by the id messages_list returns.

<div className="tool-route"><span className="tool-row-method" data-method="GET">GET</span><code>{"https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/{id}"}</code></div>

```python gmail_messages_get.py theme={null}
from charter.packs import gmail

result = await gmail.messages_get.ainvoke({"id": ...})
```

<Note>
  Requires `https://www.googleapis.com/auth/gmail.modify`. Costs 20 against the provider's own quota.
</Note>

## Path parameters

<div className="reference-table">
  | Field                                                      | Type     | Description                                                                                                                                                                                             |
  | ---------------------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `userId`                                                   | `string` | The user's email address. The special value 'me' can be used to indicate the authenticated user. <span className="field-constraints">defaults to `"me"`</span>                                          |
  | `id` <span className="required" title="required">\*</span> | `string` | The ID of the message to retrieve. This ID is usually retrieved using messages.list. The ID is also contained in the result when a message is inserted (messages.insert) or imported (messages.import). |
</div>

## Query parameters

<div className="reference-table">
  | Field             | Type                                                                | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
  | ----------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `format`          | [MessageFormat](/charter/charter/packs/gmail/message/objects#messageformat) | The format to return the message in. Gmail applies 'full' when this is absent. 'minimal' returns only email message ID and labels; does not return the email headers, body, or payload. 'full' returns the full email message data with body content parsed in the payload field; the raw field is not used. 'raw' returns the full email message data with body content in the raw field as a base64url encoded string; the payload field is not used. 'metadata' returns only email message ID, labels, and email headers. 'full' and 'raw' cannot be used when accessing the api using the gmail.metadata scope. |
  | `metadataHeaders` | `string`\[]                                                         | When given and format is METADATA, only include headers specified. Gmail ignores it under any other format.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
</div>