Emails

Get an email

Fetch one email with its body – the only endpoint that returns the body. A null body means none was stored; if the stored body can't be read right now the call returns 503 rather than a false empty.

Requires one of the following scopes: emails:read, emails:all, all:read, all:all.

get/v1/emails/{id}

Request

  • Base URL: https://api.mailbeast.ai
  • URL: https://api.mailbeast.ai/v1/emails/{id}
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Response

idstring required
threadIdstring nullable required

Conversation this email belongs to. null when the email is not part of a conversation. An opaque identifier: pass it back as-is, do not parse or construct it.

messageIdstring nullable required

RFC 5322 Message-ID as set by the sending server.

tostring[] required
ccstring[] required
bccstring[] required
subjectstring required
snippetstring nullable required

Short preview of the message. Always present in list results.

isUnreadboolean nullable required

Read state. null when the email is not part of a conversation and therefore has no read state, which is not the same as read.

type'sent' | 'received' required
campaignIdstring nullable required
leadIdstring nullable required
hasAttachmentsboolean required
receivedAtstring date-time required
sentAtstring date-time nullable required

Example response

{
  "id": "8c5a1e07-2b93-4d6f-a0e8-7c4b9d1f2a36",
  "threadId": "13a265fd-f0f2-b1d1-d6fc-154e483183e7",
  "messageId": "<CAF=abc123@mail.gmail.com>",
  "mailbox": {
    "id": "3f1c2b7e-9a4d-4c8e-b1f6-5d2a7e0c3b94",
    "email": "jane@acme.com"
  },
  "from": {
    "email": "john@prospect.io",
    "name": "John Carter"
  },
  "to": [
    "jane@acme.com"
  ],
  "cc": [],
  "bcc": [],
  "subject": "Re: Pricing question",
  "snippet": "Thanks for the details, this works for us.",
  "isUnread": true,
  "type": "received",
  "campaignId": "c1f3b0a2-6d4e-4f8b-9a1c-2e5d7f0a3b6c",
  "leadId": "9d4e2f10-5b6a-4c73-8e19-0f2a7c4d8b31",
  "receivedAt": "2026-07-13T09:24:11.000Z",
  "sentAt": "2026-07-13T09:24:09.000Z",
  "body": {
    "html": "<p>Thanks for the details, this works for us.</p>",
    "text": "Thanks for the details, this works for us."
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.