Skip to main content
GET
Get outbound email logs

Authorizations

Authorization
string
header
required

API key for account management endpoints. Use your api_ prefixed token.

Query Parameters

limit
integer
default:50

Number of records to return (1-100)

Required range: 1 <= x <= 100
page
integer
default:1

Page number for pagination (starts from 1)

Required range: x >= 1
offset
integer
default:0

Number of records to skip (alternative to page)

Required range: x >= 0
sort_by
string
default:date

Field to sort by

Maximum string length: 50
sort_order
enum<string>
default:DESC

Sort order

Available options:
ASC,
DESC
id
string

Filter by record ID

Maximum string length: 100
uid
string

Filter by unique identifier

Pattern: ^[A-Za-z0-9-_]{1,100}$
action
enum<string>

Filter by email action status

Available options:
ACCEPTED,
REJECTED,
BOUNCED_HARD,
BOUNCED_SOFT,
DEFERRED,
SPAM,
VIRUS,
QUEUED,
COMPLAINT
zone
string

Filter by zone

Maximum string length: 50
message_id
string

Filter by message ID

Maximum string length: 100
from_address
string<email>

Filter by sender email address

to_address
string<email>

Filter by recipient email address

mx
string

Filter by MX server

Maximum string length: 100
host
string

Filter by host server

Maximum string length: 100
ip
string

Filter by IP address

Pattern: ^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$
response
string

Filter by server response

Maximum string length: 500
user
string<email>

Filter by username

protocol
enum<string>

Filter by protocol

Available options:
smtp,
http,
https
src
string

Filter by source

Maximum string length: 50
subject
string

Filter by email subject

Maximum string length: 500
md5
string

Filter by MD5 hash

Pattern: ^[a-fA-F0-9]{32}$
interface
string

Filter by interface

Maximum string length: 50
originhost
string

Filter by origin host

Maximum string length: 100
transtype
enum<string>

Filter by transport type

Available options:
smtp,
http,
api
headerFrom
string<email>

Filter by header From field

date_from
integer

Filter by start date (Unix timestamp)

Required range: x >= 0
date_to
integer

Filter by end date (Unix timestamp)

Required range: x >= 0
from
string<date>

Filter by start date (YYYY-MM-DD or ISO format)

to
string<date>

Filter by end date (YYYY-MM-DD or ISO format)

rule_id
string

Filter by rule ID

Maximum string length: 100

General search term (searches across email fields)

Maximum string length: 200

Response

Successfully retrieved logs grouped by message uid

success
boolean
Example:

true

pagination
object
data
object[]

One entry per message, aggregated from all events recorded against its uid