> For the complete documentation index, see [llms.txt](https://docs.maildrop.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maildrop.cc/graphql-types/message.md).

# Message

```graphql
type Message {
        id: String
        ip: String
        helo: String
        date: String
        mailfrom: String
        rcptto: [String]
        headerfrom: String
        subject: String
        data: String
        html: String
}
```

<table><thead><tr><th width="159">Field</th><th>Description</th></tr></thead><tbody><tr><td><strong>id</strong></td><td>A 10-character unique id for each message.</td></tr><tr><td><strong>ip</strong></td><td>The ip address of the originating mail server. This can be in either ipv4 or ipv6 format.</td></tr><tr><td><strong>helo</strong></td><td>The domain specified in the RFC 821 "HELO (domain)" SMTP greeting sent by the originating mail server.</td></tr><tr><td><strong>date</strong></td><td>An ISO-8601 compatible string representing the date the message was received by Maildrop.</td></tr><tr><td><strong>mailfrom</strong></td><td>The email address specified in the RFC 821 "MAIL FROM:&#x3C;address@domain.com>" SMTP sender sent by the originating mail server.</td></tr><tr><td><strong>rcptto</strong></td><td>An array of destination addresses specified in the RFC 821 "RCPT TO:&#x3C;destination@you.com>" SMTP recipient sent by the originating mail server.</td></tr><tr><td><strong>headerfrom</strong></td><td>The contents of the "From:" header in the email message.</td></tr><tr><td><strong>subject</strong></td><td>The contents of the "Subject:" header in the email message.</td></tr><tr><td><strong>data</strong></td><td>The raw SMTP email message sent to Maildrop.</td></tr><tr><td><strong>html</strong></td><td>If the message contained a MIME multipart html, that html data is here, otherwise this field contains the plain text body of the message.</td></tr></tbody></table>

{% hint style="danger" %}
**Note**: The **data** and **html** fields are only available when you are querying [a specific message](/api-reference/get-a-specific-message.md). For performance reasons, you should get the listing of messages, then retrieve the messages you're looking for one at a time.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.maildrop.cc/graphql-types/message.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.