boundry.
RegionSydney, Australia
Documentation/Get a received email
GET/emails/receiving/{emailId}

Get a received email

Authentication

Bearer authentication is required for this operation.

Path parameters

NameTypeDescription
emailIdrequiredstring

Email identifier.

Request examples

request.sh
bash
curl --request GET 'https://api.au.boundry.dev/emails/receiving/string' \
+  -H 'Authorization: Bearer $BOUNDRY_API_KEY' \
+

200 response

The received email.

FieldTypeDescription
attachmentsrequiredarray

Inbound attachment metadata; unsupported in local mode.

content_typerequiredstring

Attachment media type. Example: "application/pdf".

filenamerequiredstring

Original attachment filename. Example: "invoice.pdf".

idrequiredstring

Attachment identifier. Example: "msg_01j0example".

sizerequiredinteger

Attachment size in bytes. Example: 1234.

bccrequiredarray

Blind-carbon-copy recipients.

ccrequiredarray

Carbon-copy recipients.

channelrequiredstring

Messaging channel. Values: "email".

created_atrequiredstring (date-time)

Timestamp when Boundry accepted the message. Example: "2026-08-14T12:00:00.000Z".

fromrequiredstring

Sender email address. Example: "hello@example.com".

htmlrequiredstring | null | null

HTML body, or null when omitted.

Option 1string

HTML email content.

Option 2null | null

One permitted response shape.

idrequiredstring

Message identifier. Example: "msg_01j0example".

last_eventrequiredstring

Inbound lifecycle event. Values: "received", "stored".

objectrequiredstring

Resource type discriminator. Values: "email".

project_idrequiredstring

Owning project identifier. Example: "msg_01j0example".

reply_torequiredarray

Reply-to addresses.

subjectrequiredstring

Email subject.

tagsrequiredarray

Message tags.

namerequiredstring

Tag name. Example: "campaign".

valuerequiredstring

Tag value. Example: "welcome".

textrequiredstring | null | null

Plain-text body, or null when omitted.

Option 1string

Plain-text email content.

Option 2null | null

One permitted response shape.

torequiredarray

Receiving addresses.

response.jsonExample response
application/json
{
  "emailId": "rcv_01j0example"
}

401 response

Invalid API key.

FieldTypeDescription
errorsarray

Detailed validation issues. Absent only for the historical 401 API-key envelope.

coderequiredstring

Zod validation issue code. Example: "invalid_format".

messagerequiredstring

Human-readable validation failure. Example: "Invalid email address".

pathrequiredstring

Dot-separated location of the invalid value. Example: "from".

messagerequiredstring

Human-readable error message. Example: "Request validation failed.".

namerequiredstring

Machine-readable error category. Values: "validation_error", "application_error", "not_found". Example: "validation_error".

response.jsonExample response
application/json
{
  "emailId": "rcv_01j0example"
}

404 response

Requested resource was not found.

FieldTypeDescription
errorsarray

Detailed validation issues. Absent only for the historical 401 API-key envelope.

coderequiredstring

Zod validation issue code. Example: "invalid_format".

messagerequiredstring

Human-readable validation failure. Example: "Invalid email address".

pathrequiredstring

Dot-separated location of the invalid value. Example: "from".

messagerequiredstring

Human-readable error message. Example: "Request validation failed.".

namerequiredstring

Machine-readable error category. Values: "validation_error", "application_error", "not_found". Example: "validation_error".

response.jsonExample response
application/json
{
  "emailId": "rcv_01j0example"
}

422 response

Request validation failed.

FieldTypeDescription
errorsarray

Detailed validation issues. Absent only for the historical 401 API-key envelope.

coderequiredstring

Zod validation issue code. Example: "invalid_format".

messagerequiredstring

Human-readable validation failure. Example: "Invalid email address".

pathrequiredstring

Dot-separated location of the invalid value. Example: "from".

messagerequiredstring

Human-readable error message. Example: "Request validation failed.".

namerequiredstring

Machine-readable error category. Values: "validation_error", "application_error", "not_found". Example: "validation_error".

response.jsonExample response
application/json
{
  "emailId": "rcv_01j0example"
}