GET
/
api
/
v1
/
email

Authorizations

Authorization
string
headerrequired

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

Query Parameters

valid_only
boolean
default: true

If true, only valid emails are returned

inbox_id
string | null

If provided, only emails from the specified inbox are returned

limit
integer
default: 100

The maximum number of emails to return

Response

200 - application/json
id
string
required
status
enum<string>
required
Available options:
valid,
invalid_to_address,
not_allowed_from_address,
not_allowed_cc_address,
not_allowed_bcc_address,
blocked_from_address,
spf_fail,
dkim_fail,
dmarc_fail
status_message
string | null
required

Additional information about the status of the email, e.g. why SPF failed

user_mark_status
boolean
default: false

If true, the email has been manually marked valid is considered valid even if the status is not valid

inbox_id
string
required
to_addresses
object[]
required
cc_addresses
object[]
required
bcc_addresses
object[]
required
reply_to_addresses
object[]
required
from_address
object
required
subject
string
required
date
string
required

The date the email was sent in UTC, ISO 8601 format

latest_webhook_log
object | null
required