Skip to main content

GET /snds/aggregated_traps

GET 

snds/aggregated_traps

Retrieve aggregated Microsoft SNDS spam trap hit statistics

Query Parameters

period_from string Required
Start of the time period (e.g., 2021-07-06T00:00:00.000Z)

period_to string Required
End of the time period (e.g., 2021-08-06T00:00:00.000Z). The range between period_from and period_to must not exceed 30 days

filter_result string
Comma-separated list of filter results to filter by

ips string
Comma-separated list of IP addresses to filter by. Each value can be a full or partial match

rdns string
Comma-separated list of reverse DNS hostnames to filter by. Each value can be a full or partial match

profile_id string
Filter by profile ID

Returns

  • dataarray
    • ipstring
      Sending IP address that hit spam traps
    • dns_reverse_resultarray
      Reverse DNS lookup results for the IP address
      • rdnsstring
        Reverse DNS hostname
    • trap_hitsnumber
      Total number of spam trap hits for this IP in the given period
Error Codes

400 Bad Request

Bad Request

401 Unauthorized

Unauthorized

403 Forbidden

Forbidden

500 Internal Server Error

Internal server error