Skip to main content

GET /traps/log

GET 

traps/log

Retrieve the event logs of emails hitting monitored spam trap addresses

Query Parameters

ip string
Filter by IP address substring

domain_from string
Filter by domain_from substring

offset string
Number of items to skip before starting to return results

limit string
Maximum number of items to return per request

sort string
Example: -timestamp (desc) or timestamp (asc)

Returns

  • dataarray
    • idstring
      Unique identifier of the trap log entry
    • ipstring
      Sending IP address that triggered the trap
    • domain_fromstring
      Sender domain extracted from the email envelope
    • email_from_headerstring
      Sender address from the email From header
    • email_subjectstring
      Subject line of the email that triggered the trap
    • smtp_mail_from_domainstring
      Domain from the smtp_mail_from_domain command
    • data_colorcodestring
      Threat classification color code assigned to this trap hit
      Allowed values: black, grey
    • trap_estimated_domain_age_daysnumber
      Estimated age of the sender domain in days at the time of the trap hit
    • timestampstring
      Timestamp when the trap was triggered
  • metaobject
    Pagination metadata for list responses
    • countinteger
      Total number of items available
    • offsetinteger
      Number of items skipped
    • limitinteger
      Maximum number of items returned per request
Error Codes

401 Unauthorized

Unauthorized

403 Forbidden

Forbidden

404 Not Found

Not Found

500 Internal Server Error

Internal server error