Skip to main content

GET /dmarc/{id}/ips

GET 
dmarc/:id/ips

Retrieve all sending IP addresses with aggregated statistics for a specific DMARC domain

Path Parameters​

id string Required
domain id

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., -ip for descending or ip 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

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
    • dispositionstring
      Policy action applied by the receiving server
    • rdnsstring
      Reverse DNS lookup result for the IP address
    • org_namestring
      Organization name that reported this data
    • header_fromstring
      Domain from the email header From field
    • 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
    • ip_countrystring
      Country code of the source IP address
  • 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