For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
  • FreeCustom.Email API
        • GETList inboxes
        • POSTRegister an inbox
          • DELUnregister an inbox
            • GETList messages
              • GETGet a message
              • DELDelete a message
LogoLogo
FreeCustom.Email APIV1InboxesInboxMessagesID

Get a message

||View as Markdown|
GET
https://api2.freecustom.email/v1/inboxes/:inbox/messages/:id
GET
/v1/inboxes/:inbox/messages/:id
$curl https://api2.freecustom.email/v1/inboxes/%7B%7Bmailbox%7D%7D/messages/%7B%7BmessageId%7D%7D \
>     -H "Authorization: Bearer <token>"
1{
2  "success": true,
3  "data": {
4    "id": "string",
5    "from": "string",
6    "to": "string",
7    "subject": "string",
8    "date": "1968-01-21T06:13:21.308Z",
9    "html": "string",
10    "text": "string",
11    "otp": "string",
12    "verification_link": "string",
13    "has_attachment": false,
14    "attachments": [
15      {
16        "filename": "string",
17        "content_type": "string",
18        "size_bytes": 1365
19      },
20      {
21        "filename": "string",
22        "content_type": "string",
23        "size_bytes": 9863
24      }
25    ]
26  }
27}
Retrieves the full content of a single message by its ID, including HTML body, plain-text body, headers, metadata, and any attachments. **Path parameters:** - `:inbox` — URL-encoded inbox address (e.g., `test%40domain.com`) - `:id` — Message ID returned by `GET /v1/inboxes/:inbox/messages` **Response fields:** - `id` — Unique message identifier - `from` — Sender address - `subject` — Email subject line - `html` — Full HTML body - `text` — Plain-text body - `receivedAt` — ISO 8601 timestamp - `attachments` — Array of attachment objects (name, size, mimeType, url); availability depends on plan - `otp` — Extracted OTP value if detected (`"__DETECTED__"` on plans below Growth) **Plan:** All plans. Attachment access requires Developer plan or higher. OTP value requires Growth plan or higher.
Was this page helpful?
Previous

List messages

Next

Delete a message

Built with

Retrieves the full content of a single message by its ID, including HTML body, plain-text body, headers, metadata, and any attachments.

Path parameters:

  • :inbox — URL-encoded inbox address (e.g., test%40domain.com)
  • :id — Message ID returned by GET /v1/inboxes/:inbox/messages

Response fields:

  • id — Unique message identifier
  • from — Sender address
  • subject — Email subject line
  • html — Full HTML body
  • text — Plain-text body
  • receivedAt — ISO 8601 timestamp
  • attachments — Array of attachment objects (name, size, mimeType, url); availability depends on plan
  • otp — Extracted OTP value if detected ("__DETECTED__" on plans below Growth)

Plan: All plans. Attachment access requires Developer plan or higher. OTP value requires Growth plan or higher.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

inboxstringRequired
idstringRequired

Response

OK
successboolean
dataobject

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error