Get the specified email thread
GET {{baseUrl}}/emails/mailboxes/:email/threads/:threadId?format=full&metadataHeaders=<string>&maxResults=<string>&pageToken=<string>
Retrieves the specified thread.
Scopes: mail:read
Rate Limit Label: LIGHT
Not supported in Gov cluster
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
format | string | The format to return the messages in. | |
metadataHeaders | string | When requested format is metadata, only include headers specified in this query parameter. | |
maxResults | string | Maximum number of thread messages to return. This field defaults to 50. The maximum allowed value for this field is 500. | |
pageToken | string | Page token to retrieve a specific page of results in the list. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"id":"\u003cstring\u003e","historyId":"\u003cstring\u003e","threadName":"\u003cstring\u003e","status":"ignored","messages":[{"id":"\u003cstring\u003e","threadId":"\u003cstring\u003e","labelIds":["\u003cstring\u003e","\u003cstring\u003e"],"historyId":"\u003cstring\u003e","internalDate":"\u003cstring\u003e","expiration":"\u003cstring\u003e","lastMoved":"\u003cstring\u003e","payload":{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","size":"\u003cinteger\u003e","data":"\u003cstring\u003e"},"parts":[{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","data":"\u003cstring\u003e","size":"\u003cinteger\u003e"},"parts":[{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","data":"\u003cstring\u003e","size":"\u003cinteger\u003e"},"parts":[{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","data":"\u003cstring\u003e","size":"\u003cinteger\u003e"}},{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","data":"\u003cstring\u003e","size":"\u003cinteger\u003e"}}]},{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","data":"\u003cstring\u003e","size":"\u003cinteger\u003e"},"parts":[{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","data":"\u003cstring\u003e","size":"\u003cinteger\u003e"}},{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","data":"\u003cstring\u003e","size":"\u003cinteger\u003e"}}]}]},{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","data":"\u003cstring\u003e","size":"\u003cinteger\u003e"},"parts":[{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","data":"\u003cstring\u003e","size":"\u003cinteger\u003e"},"parts":[{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","data":"\u003cstring\u003e","size":"\u003cinteger\u003e"}},{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","data":"\u003cstring\u003e","size":"\u003cinteger\u003e"}}]},{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","data":"\u003cstring\u003e","size":"\u003cinteger\u003e"},"parts":[{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","data":"\u003cstring\u003e","size":"\u003cinteger\u003e"}},{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","data":"\u003cstring\u003e","size":"\u003cinteger\u003e"}}]}]}]},"snippet":"\u003cstring\u003e","sendTime":"\u003cstring\u003e","userScheduled":"\u003cboolean\u003e","sizeEstimate":"\u003cstring\u003e"},{"id":"\u003cstring\u003e","threadId":"\u003cstring\u003e","labelIds":["\u003cstring\u003e","\u003cstring\u003e"],"historyId":"\u003cstring\u003e","internalDate":"\u003cstring\u003e","expiration":"\u003cstring\u003e","lastMoved":"\u003cstring\u003e","payload":{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","size":"\u003cinteger\u003e","data":"\u003cstring\u003e"},"parts":[{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","data":"\u003cstring\u003e","size":"\u003cinteger\u003e"},"parts":[{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","data":"\u003cstring\u003e","size":"\u003cinteger\u003e"},"parts":[{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","data":"\u003cstring\u003e","size":"\u003cinteger\u003e"}},{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","data":"\u003cstring\u003e","size":"\u003cinteger\u003e"}}]},{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","data":"\u003cstring\u003e","size":"\u003cinteger\u003e"},"parts":[{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","data":"\u003cstring\u003e","size":"\u003cinteger\u003e"}},{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","data":"\u003cstring\u003e","size":"\u003cinteger\u003e"}}]}]},{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","data":"\u003cstring\u003e","size":"\u003cinteger\u003e"},"parts":[{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","data":"\u003cstring\u003e","size":"\u003cinteger\u003e"},"parts":[{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","data":"\u003cstring\u003e","size":"\u003cinteger\u003e"}},{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","data":"\u003cstring\u003e","size":"\u003cinteger\u003e"}}]},{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","data":"\u003cstring\u003e","size":"\u003cinteger\u003e"},"parts":[{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","data":"\u003cstring\u003e","size":"\u003cinteger\u003e"}},{"partId":"\u003cstring\u003e","mimeType":"\u003cstring\u003e","filename":"\u003cstring\u003e","headers":[{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","value":"\u003cstring\u003e"}],"body":{"attachmentId":"\u003cstring\u003e","data":"\u003cstring\u003e","size":"\u003cinteger\u003e"}}]}]}]},"snippet":"\u003cstring\u003e","sendTime":"\u003cstring\u003e","userScheduled":"\u003cboolean\u003e","sizeEstimate":"\u003cstring\u003e"}]}