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. Use date-time without timezone because SNDS records are stored as calendar-date records with the timestamp set to the start of that day. Example: 2021-07-06T00:00:00.000Z. Do not send timezone offsets

period_to string Required
End of the time period. Use date-time without timezone because SNDS records are stored as calendar-date records with the timestamp set to the start of that day. Example: 2021-08-06T00:00:00.000Z. Do not send timezone offsets. 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