Skip to content

Get logs for specific message in user domain

GET
/api/domains/{domain}/log/{message_guid}

Retrieve all logs for a specific message in a domain owned by the authenticated user

domain
required
string
Example
example.com

Domain name that must be owned by the authenticated user. The domain must be verified and properly configured for email sending.

message_guid
required
string
Example
550e8400-e29b-41d4-a716-446655440000

Message GUID

Success

object
data

Array of log entries for the specific message in the user’s domain

Array<object>

Email log entry

object
id

Unique identifier for the log entry

string
Example
log-id-123
user_guid

GUID of the user who sent the email

string
Example
user-guid-123
user_domain_guid

GUID of the domain used to send the email

string
Example
domain-guid-456
event_type

Type of email event (sent, delivered, bounced, opened, clicked, etc.)

string
Example
delivered
message_guid

Unique identifier for the email message

string
Example
550e8400-e29b-41d4-a716-446655440000
timestamp

Unix timestamp when the event occurred

integer
Example
1640995200
X-RateLimit-Limit
integer

Maximum requests per minute

X-RateLimit-Remaining
integer

Remaining requests in current window

Bad Request - User authentication missing

object
error
string
Example
User authentication missing

Unauthorized - Invalid or missing authentication

object
error
string
Example
Unauthorized

Not Found - Domain or log not found

object
error
string
Example
Domain not found or you do not own this domain

Too Many Requests - Rate limit exceeded. Retry after the specified time.

object
success
boolean
message
string
Example
Too many attempts. Please try again later.
Retry-After
integer

Seconds until rate limit resets

X-RateLimit-Limit
integer

Maximum requests per minute

X-RateLimit-Remaining
integer

Remaining requests in current window

Server Error - Unexpected error occurred

object
error
string
Example
Unknown error