GET /insights/aggregated/snds
GETinsights/aggregated/snds
Retrieve aggregated SNDS Postmaster statistics, including GREEN, YELLOW, RED reputation counts, grouped by time period (last 7 days and 30 days)
Query Parameters
ip string
Filter results by IP address substring
domain string
Filter results by domain name substring
sources string
Filter results by one or more data sources. Accepts a comma-separated list of source names
dmarc string
Filter results by DMARC type. Accepts a comma-separated list of values
seedlisting string
Filter results by seedlisting placement. Accepts a comma-separated list of values
gp string
Filter results by Google Postmaster domain reputation. Accepts a comma-separated list of reputation values
snds string
Filter results by SNDS status. Accepts a comma-separated list of status values
blocklisted string
Filter results by blocklist status. Accepts a comma-separated list of status values
ip_only boolean
Filter results to include only IP-based insights (excludes domain-only records)
domain_only boolean
Filter results to include only domain-based insights (excludes IP-only records)
profile_id string
Filter results to only include IPs and domains that belong to the specified profile
Returns
- green_7dnumberTotal number of recipients where SNDS with GREEN status in the last 7 days
- green_30dnumberTotal number of recipients where SNDS with GREEN status in the last 30 days
- yellow_7dnumberTotal number of recipients where SNDS with YELLOW status in the last 7 days
- yellow_30dnumberTotal number of recipients where SNDS with YELLOW status in the last 30 days
- red_7dnumberTotal number of recipients where SNDS with RED status in the last 7 days
- red_30dnumberTotal number of recipients where SNDS with RED status in the last 30 days
401 Unauthorized
Unauthorized
403 Forbidden
Forbidden
500 Internal Server Error
Internal server error