Skip to main content

GET /dmarc/aggregated/ip

GET 
dmarc/aggregated/ip

Retrieve aggregated DMARC statistics grouped by sending IP address

Query Parameters​

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

limit string
Maximum number of items to return per request

sort string
Sort field and order (e.g., -org_name for descending or org_name for ascending)

records_date_from string Required
Start date for filtering records (e.g., 2025-07-06T00:00:00.000Z)

records_date_to string Required
End date for filtering records (e.g., 2025-08-06T00:00:00.000Z). The difference between records_date_from and records_date_to must not exceed 31 days

domain string
Filter by domain name substring

profile_id string
Filter by profile ID

ip string
Filter by IP address substring

org_name string
Filter by org_name field (Reporter)

ip_org_name string
Filter by ip_org_name field (Source)

disposition string
Filter by disposition (Policy applied)

dmarc_type string
Filter by dmarc_type (DMARC type)

policy_evaluated_reasons_type string
Filter by policy_evaluated_reasons_type (Reason Type)

policy_evaluated_reasons_comment string
Filter by policy_evaluated_reasons_comment (Reason Comment)

Returns

  • dataarray
    • ipstring
      Source IP address that sent the email
    • countnumber
      Total number of DMARC records from this IP address
    • spf_passnumber
      Number of records with SPF validation passed
    • spf_failnumber
      Number of records with SPF validation failed
    • dkim_passnumber
      Number of records with DKIM validation passed
    • dkim_failnumber
      Number of records with DKIM validation failed
    • dmarc_passnumber
      Number of records with DMARC validation passed
    • dmarc_failnumber
      Number of records with DMARC validation failed
    • spf_alignment_passnumber
      Number of records with SPF alignment passed
    • spf_alignment_failnumber
      Number of records with SPF alignment failed
    • dkim_alignment_passnumber
      Number of records with DKIM alignment passed
    • dkim_alignment_failnumber
      Number of records with DKIM alignment failed
    • spf_auth_results_passnumber
      Number of records with SPF authentication results passed
    • spf_auth_results_failnumber
      Number of records with SPF authentication results failed
    • dkim_auth_results_passnumber
      Number of records with DKIM authentication results passed
    • dkim_auth_results_failnumber
      Number of records with DKIM authentication results failed
  • 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