GET /dmarc/records

GET 
dmarc/records

Retrieve DMARC aggregate report records for the current user's monitored domains

Query Parameters

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

limit string
Maximum number of items to return per request

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

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)

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)

report_id string
Filter by report ID

Returns

• dataarray
  • idstring
    Unique identifier of the DMARC record
  • user_idstring
    User ID who owns this record
  • org_namestring
    Organization name that reported this data
  • emailstring
    Email address of the reporter
  • contact_infostring
    Additional contact information of the reporter
  • report_idstring
    Unique identifier of the DMARC report
  • record_idstring
    Unique identifier of this specific record within the report
  • period_fromstring
    Start timestamp of the reporting period
  • period_tostring
    End timestamp of the reporting period
  • domainstring
    Domain name being monitored
  • adkimstring
    DKIM alignment mode
  • aspfstring
    SPF alignment mode
  • pstring
    DMARC policy for the domain
    Allowed values: none, reject, quarantine
  • spstring
    DMARC policy for subdomains
  • pctnumber
    Percentage of messages subjected to filtering
  • ipstring
    Source IP address that sent the email
  • ip_countrystring
    Country code of the source IP address
  • ip_org_namestring
    Organization name associated with the source IP address
  • countnumber
    Number of messages matching this record
  • dispositionstring
    Policy action applied by the receiving server
  • spfstring
    Overall SPF validation result
  • dkimstring
    Overall DKIM validation result
  • dmarcstring
    Overall DMARC validation result
  • spf_alignedboolean
    Indicates if SPF alignment check passed
  • dkim_alignedboolean
    Indicates if DKIM alignment check passed
  • spf_passnumber
    Number of messages with SPF validation passed
  • spf_failnumber
    Number of messages with SPF validation failed
  • dkim_passnumber
    Number of messages with DKIM validation passed
  • dkim_failnumber
    Number of messages with DKIM validation failed
  • dmarc_passnumber
    Number of messages with DMARC validation passed
  • dmarc_failnumber
    Number of messages with DMARC validation failed
  • spf_alignment_passnumber
    Number of messages with SPF alignment passed
  • spf_alignment_failnumber
    Number of messages with SPF alignment failed
  • dkim_alignment_passnumber
    Number of messages with DKIM alignment passed
  • dkim_alignment_failnumber
    Number of messages with DKIM alignment failed
  • spf_auth_results_passnumber
    Number of messages with SPF authentication results passed
  • spf_auth_results_failnumber
    Number of messages with SPF authentication results failed
  • dkim_auth_results_passnumber
    Number of messages with DKIM authentication results passed
  • dkim_auth_results_failnumber
    Number of messages with DKIM authentication results failed
  • envelope_fromstring
    Domain from the SMTP MAIL FROM command
  • header_fromstring
    Email address from the message header From field
  • header_from_domainstring
    Domain extracted from the header From field
  • auth_resultsobject
    Detailed authentication results for SPF and DKIM
    • dkimarray
      List of DKIM authentication results
      • _idstring
        Unique identifier of this DKIM result
      • domainstring
        Domain against which the DKIM signature was validated
      • resultstring
        DKIM validation result
      • selectorstring
        DKIM selector used for public key lookup
    • spfarray
      List of SPF authentication results
      • _idstring
        Unique identifier of this SPF result
      • domainstring
        Domain against which the SPF record was evaluated
      • resultboolean
        Indicates whether the SPF check passed
  • policy_evaluated_reasonsarray
    List of reasons for policy evaluation decisions
    • _idstring
      Unique identifier of this reason
    • typestring
      Type of policy evaluation reason
    • commentstring
      Additional comment explaining the reason
  • created_atstring
    Timestamp when this record was created in the system
• 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