# Message

## Message summary

Returns a JSON summary of the message and attachments.

**URL** : `api/v1/message/<ID>`

**Method** : `GET`

## Response

**Status** : `200`

```json
{
  "ID": "d7a5543b-96dd-478b-9b60-2b465c9884de",
  "MessageID": "12345.67890@localhost",
  "Read": true,
  "From": {
    "Name": "John Doe",
    "Address": "john@example.com"
  },
  "To": [
    {
      "Name": "Jane Smith",
      "Address": "jane@example.com"
    }
  ],
  "Cc": [],
  "Bcc": [],
  "ReplyTo": [],
  "Subject": "Message subject",
  "Date": "2016-09-07T16:46:00+13:00",
  "Tags": ["test"],
  "Text": "Plain text MIME part of the email",
  "HTML": "HTML MIME part (if exists)",
  "Size": 79499,
  "Inline": [
    {
      "PartID": "1.2",
      "FileName": "filename.gif",
      "ContentType": "image/gif",
      "ContentID": "919564503@07092006-1525",
      "Size": 7760
    }
  ],
  "Attachments": [
    {
      "PartID": "2",
      "FileName": "filename.doc",
      "ContentType": "application/msword",
      "ContentID": "",
      "Size": 43520
    }
  ]
}
```
### Notes

- `Read` - always true (message marked read on open)
- `From` - Name & Address, or null
- `To`, `CC`, `BCC`, `ReplyTo` - Array of Names & Address
- `Date` - Parsed email local date & time from headers
- `Size` - Total size of raw email
- `Inline`, `Attachments` - Array of attachments and inline images.


---
## Attachments

**URL** : `api/v1/message/<ID>/part/<PartID>`

**Method** : `GET`

Returns the attachment using the MIME type provided by the attachment `ContentType`.

---
## Headers

**URL** : `api/v1/message/<ID>/headers`

**Method** : `GET`

Returns all message headers as a JSON array.
Each unique header key contains an array of one or more values (email headers can be listed multiple times.)

```json
{
  "Content-Type": [
    "multipart/related; type=\"multipart/alternative\"; boundary=\"----=_NextPart_000_0013_01C6A60C.47EEAB80\""
  ],
  "Date": [
    "Wed, 12 Jul 2006 23:38:30 +1200"
  ],
  "Delivered-To": [
    "user@example.com",
    "user-alias@example.com"
  ],
  "From": [
    "\"User Name\" \\u003remote@example.com\\u003e"
  ],
  "Message-Id": [
    "\\u003c001701c6a5a7$b3205580$0201010a@HomeOfficeSM\\u003e"
  ],
....
}
```


---
## Raw (source) email

**URL** : `api/v1/message/<ID>/raw`

**Method** : `GET`

Returns the original email source including headers and attachments.