GET /insights/{id}

GET 
insights/:id

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

Path Parameters

id string Required
Insight ID

Returns

• 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

Error Codes

400 Bad Request

Bad Request

401 Unauthorized

Unauthorized

403 Forbidden

Forbidden

404 Not Found

Not Found

500 Internal Server Error

Internal server error