GET /insights

GET 
insights

Retrieve all insights for IPs and domains detected in the last 24 hours, 7 days, or 30 days, including their source and all related information

Query Parameters

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

limit string
Maximum number of items to return per request

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

• dataarray
  List of insight records
  • idstring
    Unique identifier of the insight record
  • ipstring
    IP address associated with this insight
  • domainstring
    Domain name associated with this insight
  • sourcesarray
    List of data sources that detected this IP or domain
  • rblobject
    Blocklist status and listing count for this IP or domain
    • listedboolean
      Indicates whether the IP or domain is currently listed on one or more blocklists
    • list_countnumber
      Total number of blocklists on which the IP or domain is currently listed
  • seedlistingobject
    Seedlisting statistics for this IP or domain
    • inbox_24hnumber
      Number of seedlisting emails delivered to inbox in the last 24 hours
    • inbox_7dnumber
      Number of seedlisting emails delivered to inbox in the last 7 days
    • inbox_30dnumber
      Number of seedlisting emails delivered to inbox in the last 30 days
    • spam_24hnumber
      Number of seedlisting emails delivered to spam in the last 24 hours
    • spam_7dnumber
      Number of seedlisting emails delivered to spam in the last 7 days
    • spam_30dnumber
      Number of seedlisting emails delivered to spam in the last 30 days
    • count_24hnumber
      Total number of seedlisting emails processed in the last 24 hours
    • count_7dnumber
      Total number of seedlisting emails processed in the last 7 days
    • count_30dnumber
      Total number of seedlisting emails processed in the last 30 days
  • dmarcobject
    DMARC validation statistics for this IP or domain
    • dmarc_pass_24hnumber
      Number of emails that passed DMARC validation in the last 24 hours
    • dmarc_pass_7dnumber
      Number of emails that passed DMARC validation in the last 7 days
    • dmarc_pass_30dnumber
      Number of emails that passed DMARC validation in the last 30 days
    • dmarc_fail_24hnumber
      Number of emails that failed DMARC validation in the last 24 hours
    • dmarc_fail_7dnumber
      Number of emails that failed DMARC validation in the last 7 days
    • dmarc_fail_30dnumber
      Number of emails that failed DMARC validation in the last 30 days
    • count_24hnumber
      Total number of emails in DMARC monitoring in the last 24 hours
    • count_7dnumber
      Total number of emails in DMARC monitoring in the last 7 days
    • count_30dnumber
      Total number of emails in DMARC monitoring in the last 30 days
  • gpobject
    Google Postmaster domain reputation statistics
    • high_7dnumber
      Number of days with HIGH domain reputation reported by Google Postmaster in the last 7 days
    • high_30dnumber
      Number of days with HIGH domain reputation reported by Google Postmaster in the last 30 days
    • medium_7dnumber
      Number of days with MEDIUM domain reputation reported by Google Postmaster in the last 7 days
    • medium_30dnumber
      Number of days with MEDIUM domain reputation reported by Google Postmaster in the last 30 days
    • low_7dnumber
      Number of days with LOW domain reputation reported by Google Postmaster in the last 7 days
    • low_30dnumber
      Number of days with LOW domain reputation reported by Google Postmaster in the last 30 days
    • bad_7dnumber
      Number of days with BAD domain reputation reported by Google Postmaster in the last 7 days
    • bad_30dnumber
      Number of days with BAD domain reputation reported by Google Postmaster in the last 30 days
  • sndsobject
    SNDS filter status statistics for this IP
    • green_7dnumber
      Number of recipients associated with a GREEN SNDS filter status in the last 7 days
    • green_30dnumber
      Number of recipients associated with a GREEN SNDS filter status in the last 30 days
    • yellow_7dnumber
      Number of recipients associated with a YELLOW SNDS filter status in the last 7 days
    • yellow_30dnumber
      Number of recipients associated with a YELLOW SNDS filter status in the last 30 days
    • red_7dnumber
      Number of recipients associated with a RED SNDS filter status in the last 7 days
    • red_30dnumber
      Number of recipients associated with a RED SNDS filter status in the last 30 days
  • alertsobject
    Alert counts triggered for this IP or domain
    • count_24hnumber
      Number of alerts triggered for this IP or domain in the last 24 hours
    • count_7dnumber
      Number of alerts triggered for this IP or domain in the last 7 days
    • count_30dnumber
      Number of alerts triggered for this IP or domain in the last 30 days
  • created_atstring
    Timestamp when this insight record was created
  • updated_atstring
    Timestamp when this insight record was last updated
• 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

400 Bad Request

Bad Request

401 Unauthorized

Unauthorized

403 Forbidden

Forbidden

500 Internal Server Error

Internal server error