Skip to main content

GET /dmarc/aggregated/ip_country

GET 
dmarc/aggregated/ip_country

Retrieve aggregated DMARC statistics grouped by ip_country

Query Parameters​

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
    • ip_countrystring
      Country code of the source IP address
    • countnumber
      Total number of DMARC records from this country
    • 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
Error Codes

400 Bad Request

Bad Request

401 Unauthorized

Unauthorized

403 Forbidden

Forbidden

500 Internal Server Error

Internal server error