List received emails

GEThttps://api.mailfully.com/v1/emails/receiving

List the organization's received email, newest first. Rows carry metadata only; fetch one email for its body.

Paging runs both ways. Pass a response's next_cursor as after for the next, older page, or its prev_cursor as before to walk back toward newer mail. after and before cannot be combined. Every page is newest first whichever way it was reached, and has_more says whether another page lies in the direction you are moving.

Received mail has no test or live split: a mf_test_ key reads the same mail as a mf_live_ key. Rows older than the plan's retention window are never returned. Requires the read:inbound scope; send and read:emails do not grant it.

Loading code example

Loading code example

Authorizations

Authorizationstringheaderrequired

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

Query Parameters

limitintegerdefault: 25

Maximum rows to return. Default 25, clamped to [1, 100].

Required range: x >= 1, x <= 100

Default: 25

afterstring

A previous response's next_cursor. Continues to older mail.

beforestring

A previous response's prev_cursor. Walks back to newer mail.

qstring

Text (1-200 characters) matched as a substring of the subject, the sender address, or the sender's display name.

Length: >= 1, <= 200

domainstring

Only mail sent to an address at this domain (matched against received_for).

has_attachments"true"

Only mail with at least one attachment. Accepts true only.

Allowed values: "true"

spam"true"

Only mail whose spam verdict is FAIL. Accepts true only.

Allowed values: "true"

Response

application/json

A page of received emails.

dataarray<object>required

data.idstringrequired

The received email id (inb_…).

data.created_atstring<date-time>required

When Mailfully received the email.

data.fromstringrequired

The sender's bare address.

data.from_headerstringrequired

The From header as written, display name included. Empty when absent.

data.toarray<string>required

Addresses in the To header.

data.ccarray<string>required

Addresses in the Cc header.

data.received_forarray<string>required

The envelope recipients at this organization's domains, lowercased. Includes blind-copied recipients and never lists another organization's addresses.

data.subjectstringrequired

The subject, or an empty string when there is none.

data.message_idstringrequired

The Message-ID header, or null when the sender set none.

data.attachment_countintegerrequired

data.spam"PASS" | "FAIL" | "GRAY" | "PROCESSING_FAILED" | nullrequired

An SES verdict. GRAY means SES had nothing to check or could not decide; null means SES reported no verdict.

Allowed values: "PASS" | "FAIL" | "GRAY" | "PROCESSING_FAILED" | null

data.virus"PASS" | "FAIL" | "GRAY" | "PROCESSING_FAILED" | nullrequired

An SES verdict. GRAY means SES had nothing to check or could not decide; null means SES reported no verdict.

Allowed values: "PASS" | "FAIL" | "GRAY" | "PROCESSING_FAILED" | null

data.quota_lockedbooleanrequired

true while the email is locked because it arrived over the monthly ceiling or spend cap and usage is still over. Its content endpoints return 403 email_above_quota until then.

has_morebooleanrequired

Whether another page lies in the direction of travel.

next_cursorstringrequired

Pass as after for older mail; null when there is none.

prev_cursorstringrequired

Pass as before for newer mail; null on the newest page.