Emails

Retrieve outbound SMTP email

Retrieve a specific outbound SMTP email by ID or Message-ID. You can pass either the email's unique ID or its Message-ID header value.

Authentication: This endpoint supports both API token authentication and alias credentials authentication.

get/v1/emails/{id}

Request

  • Base URL: https://api.forwardemail.net
  • URL: https://api.forwardemail.net/v1/emails/{id}
  • Auth: HTTP basic

Response

Email retrieved successfully

is_redactedboolean
hard_bouncesstring[]
soft_bouncesstring[]
is_bounceboolean
is_dsnboolean

True for a delivery status notification (such as a bounce) about an email you sent

aliasstring required
domainstring required
userstring required
status'pending' | 'queued' | 'sent' | 'partially_sent' | 'deferred' | 'bounced' | 'rejected' required

The current status of the email. Scheduling is determined by the date field.

is_lockedboolean
messageIdstring
datestring date-time

The email's Date header. If set to a future time (more than 1 minute ahead), the email will be held until that time. Maximum 30 days in the future from creation.

subjectstring
acceptedstring[]
idstring required
objectstring required
created_atstring date-time
updated_atstring date-time
linkstring uri
requireTLSboolean

Indicates if TLS is required for the entire delivery chain (RFC 8689).

Example response

{
  "is_redacted": true,
  "hard_bounces": [],
  "soft_bounces": [],
  "is_bounce": false,
  "is_dsn": false,
  "alias": "67a180fxxxxxxxe46a3f0edf",
  "domain": "5efae85dxxxxxxxf4bb53c7a",
  "user": "5efabd3907xxxxxxx12890b8",
  "status": "sent",
  "is_locked": false,
  "envelope": {
    "from": "test@test.com",
    "to": [
      "test@test1.com"
    ]
  },
  "messageId": "1a04fee3-5230-4a85-9111-a2c376835885@forwardemail.net",
  "date": "2025-06-04T03:32:19.000Z",
  "subject": "testing",
  "accepted": [
    "test@test1.com"
  ],
  "id": "683fbe4d5baef1b583a1xxxx",
  "object": "email",
  "created_at": "2025-06-04T03:32:29.138Z",
  "updated_at": "2025-06-04T03:32:33.847Z",
  "link": "https://forwardemail.net/my-account/emails/683fbe4d5baef1b583a11e54"
}

Changes

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