To retrieve all IP and domain insights associated with your account, use the API https://api-doc.emailconsul.com/get-insights. This API returns a list of insights containing data across all sources in the last 24 hours, 7 days, and 30 days (see Insight base model)
This endpoint supports filtering. See Insights Filters Parameters section for available parameters.
To retrieve a single insight by its unique identifier, use the API https://api-doc.emailconsul.com/get-insight-by-id. This API returns a single insight containing data across all sources in the last 24 hours, 7 days, and 30 days (see Insight base model)
To retrieve aggregated IP statistics within Insights grouped by blocklist status, use the API https://api-doc.emailconsul.com/get-insights-aggregated-ips. This API returns the total number of IPs by monitoring status.
This endpoint supports filtering. See Insights Filters Parameters section for available parameters.
Response item description:
To retrieve aggregated domain statistics within Insights grouped by blocklist status, use the API https://api-doc.emailconsul.com/get-insights-aggregated-domains. This API returns the total number of domains by monitoring status.
This endpoint supports filtering. See Insights Filters Parameters section for available parameters.
Response item description:
To retrieve aggregated alerts statistics within Insights for different time periods, use the API https://api-doc.emailconsul.com/get-insights-aggregated-alerts. This API returns the total number of alerts detected in the last 24 hours, 7 days, and 30 days.
This endpoint supports filtering. See Insights Filters Parameters section for available parameters.
Response item description:
To retrieve aggregated DMARC statistics within Insights, use the API https://api-doc.emailconsul.com/get-insights-aggregated-dmarc. This API returns aggregated compliant and threat counts in the last 24 hours, 7 days, and 30 days.
This endpoint supports filtering. See Insights Filters Parameters section for available parameters.
Response item description:
To retrieve aggregated seedlisting statistics within Insights, use the API https://api-doc.emailconsul.com/get-insights-aggregated-seedlisting. This API returns aggregated inbox and spam placement counts in the last 24 hours, 7 days, and 30 days.
This endpoint supports filtering. See Insights Filters Parameters section for available parameters.
Response item description:
To retrieve aggregated Google Postmaster reputation statistics within Insights, use the API https://api-doc.emailconsul.com/get-insights-aggregated-gp. This API returns the total number of days with each reputation level in the last 7 days and 30 days.
This endpoint supports filtering. See Insights Filters Parameters section for available parameters.
Response item description:
To retrieve aggregated SNDS statistics within Insights, use the API https://api-doc.emailconsul.com/get-insights-aggregated-snds. This API returns the total number of recipients grouped by SNDS status in the last 7 days and 30 days.
This endpoint supports filtering. See Insights Filters Parameters section for available parameters.
Response item description:
{string} id - Unique identifier of the insight record
{string} ip - IP address associated with this insight
{string} domain - Domain associated with this insight
{array} sources - List of data sources that detected this IP or domain
Available options: IPS, DOMAINS, SEEDLISTING, DMARC, GP, SNDS, ALERTS
{object} rbl - Blocklist status information
{boolean} rbl.listed - Indicates whether the IP or domain is listed in any blocklist
{number} rbl.list_count - Number of blocklists where the IP or domain is listed
{object} seedlisting - Seedlisting placement statistics
{number} seedlisting.inbox_24h - Number of emails delivered to inbox in the last 24 hours
{number} seedlisting.inbox_7d - Number of emails delivered to inbox in the last 7 days
{number} seedlisting.inbox_30d - Number of emails delivered to inbox in the last 30 days
{number} seedlisting.spam_24h - Number of emails delivered to spam in the last 24 hours
{number} seedlisting.spam_7d - Number of emails delivered to spam in the last 7 days
{number} seedlisting.spam_30d - Number of emails delivered to spam in the last 30 days
{number} seedlisting.count_24h - Total number of seedlisting emails in the last 24 hours
{number} seedlisting.count_7d - Total number of seedlisting emails in the last 7 days
{number} seedlisting.count_30d - Total number of seedlisting emails in the last 30 days
{object} dmarc - DMARC validation statistics
{number} dmarc.dmarc_pass_24h - Number of DMARC compliant emails in the last 24 hours
{number} dmarc.dmarc_pass_7d - Number of DMARC compliant emails in the last 7 days
{number} dmarc.dmarc_pass_30d - Number of DMARC compliant emails in the last 30 days
{number} dmarc.dmarc_fail_24h - Number of DMARC failed emails in the last 24 hours
{number} dmarc.dmarc_fail_7d - Number of DMARC failed emails in the last 7 days
{number} dmarc.dmarc_fail_30d - Number of DMARC failed emails in the last 30 days
{number} dmarc.count_24h - Total number of DMARC emails in the last 24 hours
{number} dmarc.count_7d - Total number of DMARC emails in the last 7 days
{number} dmarc.count_30d - Total number of DMARC emails in the last 30 days
{object} gp - Google Postmaster reputation statistics
{number} gp.high_7d - Number of days with HIGH reputation in the last 7 days
{number} gp.high_30d - Number of days with HIGH reputation in the last 30 days
{number} gp.medium_7d - Number of days with MEDIUM reputation in the last 7 days
{number} gp.medium_30d - Number of days with MEDIUM reputation in the last 30 days
{number} gp.low_7d - Number of days with LOW reputation in the last 7 days
{number} gp.low_30d - Number of days with LOW reputation in the last 30 days
{number} gp.bad_7d - Number of days with BAD reputation in the last 7 days
{number} gp.bad_30d - Number of days with BAD reputation in the last 30 days
{object} snds - SNDS status statistics
{number} snds.green_7d - Number of recipients with GREEN status in the last 7 days
{number} snds.green_30d - Number of recipients with GREEN status in the last 30 days
{number} snds.yellow_7d - Number of recipients with YELLOW status in the last 7 days
{number} snds.yellow_30d - Number of recipients with YELLOW status in the last 30 days
{number} snds.red_7d - Number of recipients with RED status in the last 7 days
{number} snds.red_30d - Number of recipients with RED status in the last 30 days
{object} alerts - Alert statistics for this IP or domain
{number} alerts.count_24h - Number of alerts triggered in the last 24 hours
{number} alerts.count_7d - Number of alerts triggered in the last 7 days
{number} alerts.count_30d - Number of alerts triggered in the last 30 days
{string} created_at - Timestamp when this insight record was created
{string} updated_at - Timestamp when this insight record was last updated
{string} ip - Filter by IP address
{string} domain - Filter by domain
{array} sources - Filter by data sources
Available options: IPS, DOMAINS, SEEDLISTING, DMARC, GP, SNDS, ALERTS
{array} dmarc - Filter by DMARC result type
Available options: threat, compliant
{array} seedlisting - Filter by seedlisting placement
Available options: INBOX, SPAM
{array} gp - Filter by Google Postmaster reputation
Available options: HIGH, MEDIUM, LOW, BAD
{array} snds - Filter by SNDS status
Available options: GREEN, YELLOW, RED
{array} blocklisted - Filter by blocklist monitoring status
Available options: CLEAN, BLOCKLISTED, NOT_MONITORED
{boolean} ip_only - Return only IP-based insights (excludes domain-only records)
{boolean} domain_only - Return only domain-based insights (excludes IP-only records)