GET /dmarc

GET 
dmarc

Retrieve all domains currently monitored for DMARC compliance

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

ip string
Filter by IP address substring

profile_id string
Filter by profile ID

org_name string
Filter by org_name field (Reporter)

ip_org_name string
Filter by ip_org_name field (Source)

p string
Filter by p field (Current DMARC policy)

disposition string
Filter by disposition (Policy applied)

dmarc_type string
Filter by dmarc_type (DMARC type)

hide_without_records boolean
Hide all domains without records for the selected period

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
  • idstring
    Unique identifier of the DMARC domain
  • domainstring
    Domain name being monitored
  • pstring
    DMARC policy for the domain
    Allowed values: none, reject, quarantine
  • warningsarray
    List of configuration warnings for the domain
  • created_atstring
    Timestamp when the domain was added to monitoring
  • recordsobject
    Aggregated DMARC statistics for the selected period
    • countnumber
      Total number of DMARC records received
    • 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
  • statusstring
    Current status of the domain processing
    Allowed values: WAITING, UPDATED, 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