Emails

List outbound SMTP emails

List outbound SMTP emails

Note that this endpoint does not return property values for an email's message, headers, nor rejectedErrors.

To return those properties and their values, please use the Retrieve email endpoint with an email ID or Message-ID.

Authentication: This endpoint supports both API token authentication and alias credentials authentication. You can authenticate using either your API key (recommended) or your alias email address and generated password.

get/v1/emails

Request

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

Query parameters

qstring

Search for emails by metadata.

domainstring

Search for emails by domain name.

is_scheduledboolean

Filter for scheduled emails (emails with future send date). Set to 'true' to show only emails scheduled to be sent in the future.

sortstring

Sort by a specific field (prefix with a single hyphen - to sort in the reverse direction of that field). Defaults to created_at if not set.

pagestring

See Pagination for more insight.

limitstring

See Pagination for more insight.

Response

List of outbound SMTP emails

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.