API referenceEmail messages
GET
/email/api/v1/emails/{id}

A 2_full email, its bodies included. Never marks it as read. The id is an emm_ id, or the engine's own (provider_id) with account_id.

Authorization

X-API-KEY<token>

Your API key from the console (gw_live_…).

In: header

Path Parameters

id*string

An email (emm_…), or the engine's own id (provider_id) with account_id.

Query Parameters

account_id?string

The mailbox (em_…): required with a provider id, else it must be the id's own.

include_headers?boolean

Its headers too.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/email/api/v1/emails/string"
{  "object": "Email",  "id": "string",  "account_id": "string",  "type": "string",  "date": "2019-08-24T14:15:22Z",  "role": "string",  "folders": [    "string"  ],  "folderIds": [    "string"  ],  "read_date": null,  "message_id": "string",  "provider_id": "string",  "body": "string",  "body_plain": "string",  "from_attendee": {    "display_name": "string",    "identifier": "string",    "identifier_type": "EMAIL_ADDRESS"  },  "to_attendees": [    {      "display_name": "string",      "identifier": "string",      "identifier_type": "EMAIL_ADDRESS"    }  ],  "cc_attendees": [    {      "display_name": "string",      "identifier": "string",      "identifier_type": "EMAIL_ADDRESS"    }  ],  "bcc_attendees": [    {      "display_name": "string",      "identifier": "string",      "identifier_type": "EMAIL_ADDRESS"    }  ],  "reply_to_attendees": [    {      "display_name": "string",      "identifier": "string",      "identifier_type": "EMAIL_ADDRESS"    }  ],  "subject": "string",  "has_attachments": true,  "origin": "string",  "in_reply_to": {    "message_id": "string",    "id": null  },  "thread_id": "string",  "attachments": [    {      "id": "string",      "name": "string",      "size": 0,      "extension": "string",      "mime": "string",      "cid": "string",      "inline": true    }  ],  "headers": [    {      "name": "string",      "value": "string"    }  ],  "gateway": {    "references": [      "string"    ],    "unread": true,    "flagged": true,    "answered": true,    "draft": true,    "is_auto_reply": true,    "is_bounce": true,    "special_use": "string",    "size": 0  },  "kind": "1_meta"}