Get inbound email logs
Retrieves logs of inbound email activity with filtering options. Either uuid (for domain) or subdomain_id parameter is required.
Authorizations
API key for account management endpoints. Use your api_ prefixed token.
Query Parameters
UUID of the inbound domain to fetch logs for. Either uuid or subdomain_id is required.
^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$ID of the subdomain to fetch logs for. Either uuid or subdomain_id is required.
x >= 1Number of records to return (1-1000)
1 <= x <= 1000Page number for pagination
x >= 1Number of records to skip (alternative to page)
x >= 0Widen the query from the domain identified by uuid to that domain plus its subdomains. Repeat once per domain. Values outside the authorised domain and its subdomains are ignored; if none are authorised the request is rejected.
Filter by unique identifier
^[A-Za-z0-9-_]{1,100}$Filter to messages that reached this stage. The full timeline of a matched message is still returned.
spam, delivery, inbound, outbound, blocked, rejected Filter by email subject
500Filter by sender email
Filter by the sender's domain. Matches the domain itself and any subdomain of it. Distinct from the recipient domain the message arrived on, which is selected with uuid/subdomain_id.
253"example.com"
Filter by recipient email
Filter by minimum spam score
x >= 0Filter by maximum spam score
x >= 0Filter by the delivery host a message was forwarded to. Only delivery events carry a host; use from_domain to filter by the sending domain.
100Filter by IP address
^(?:(?: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]?)$Filter by start date (Unix timestamp in milliseconds; values that look like seconds are scaled up)
x >= 0Filter by end date (Unix timestamp in milliseconds; values that look like seconds are scaled up)
x >= 0Field to sort by
50Sort order
ASC, DESC Response
Successfully retrieved logs
true
Consolidated log entries. Each entry represents a single inbound email (keyed by uid) with aggregated delivery/rejection counts and an actions array containing the individual underlying log rows.
Number of entries returned in this response
1