> ## Documentation Index
> Fetch the complete documentation index at: https://jetemail.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get DMARC aggregate metrics

> Returns message-weighted DMARC, aligned DKIM, aligned SPF, disposition, daily trend, and sending-source metrics. The default interval is the last 30 days.



## OpenAPI

````yaml /openapi.json get /dmarc/metrics
openapi: 3.0.0
info:
  title: JetEmail API
  version: 1.0.0
  description: API documentation for JetEmail's transactional email service.
servers:
  - url: https://api.jetemail.com
    description: Production
security:
  - apiKeyAuth: []
tags:
  - name: Email
    description: Send transactional email
  - name: Outbound
    description: 'Outbound sending: keys, SMTP users, domains, logs, suppression'
  - name: Inbound
    description: Inbound routing, domains and forward destinations
  - name: DMARC
    description: DMARC aggregate-report domain setup, DNS verification and analytics
  - name: Marketing
    description: >-
      Marketing suite: templates, audiences, contacts, broadcasts, themes,
      assets and signup forms
  - name: Signup Forms
    description: Hosted signup pages and form submissions
externalDocs:
  description: Download OpenAPI Specification
  url: /openapi.json
paths:
  /dmarc/metrics:
    get:
      tags:
        - DMARC
      summary: Get DMARC aggregate metrics
      description: >-
        Returns message-weighted DMARC, aligned DKIM, aligned SPF, disposition,
        daily trend, and sending-source metrics. The default interval is the
        last 30 days.
      parameters:
        - name: domain_uuid
          in: query
          required: false
          description: Limit metrics to one owned DMARC domain registration.
          schema:
            type: string
            format: uuid
        - name: date_from
          in: query
          required: false
          description: Inclusive interval start as Unix seconds. Defaults to 30 days ago.
          schema:
            type: integer
            format: int64
            minimum: 0
        - name: date_to
          in: query
          required: false
          description: Inclusive interval end as Unix seconds. Defaults to now.
          schema:
            type: integer
            format: int64
            minimum: 0
      responses:
        '200':
          description: DMARC aggregate metrics
          content:
            application/json:
              schema:
                type: object
                required:
                  - totals
                  - daily
                  - top_sources
                  - latest_policy
                properties:
                  totals:
                    $ref: '#/components/schemas/DmarcMetricTotals'
                  daily:
                    type: array
                    items:
                      $ref: '#/components/schemas/DmarcDailyMetric'
                  top_sources:
                    type: array
                    items:
                      $ref: '#/components/schemas/DmarcSourceMetric'
                  latest_policy:
                    allOf:
                      - $ref: '#/components/schemas/DmarcPolicyMetric'
                    nullable: true
        '400':
          description: Invalid domain UUID or date range
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DmarcError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DmarcError'
        '503':
          description: Regional DMARC metrics service is unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DmarcError'
components:
  schemas:
    DmarcMetricTotals:
      type: object
      properties:
        total_messages:
          type: integer
          format: int64
          minimum: 0
        pass_messages:
          type: integer
          format: int64
          minimum: 0
        fail_messages:
          type: integer
          format: int64
          minimum: 0
        dkim_pass_messages:
          type: integer
          format: int64
          minimum: 0
        dkim_fail_messages:
          type: integer
          format: int64
          minimum: 0
        spf_pass_messages:
          type: integer
          format: int64
          minimum: 0
        spf_fail_messages:
          type: integer
          format: int64
          minimum: 0
        disposition_none:
          type: integer
          format: int64
          minimum: 0
        disposition_quarantine:
          type: integer
          format: int64
          minimum: 0
        disposition_reject:
          type: integer
          format: int64
          minimum: 0
        report_count:
          type: integer
          format: int64
          minimum: 0
    DmarcDailyMetric:
      type: object
      properties:
        date:
          type: string
          format: date
          example: '2026-08-09'
        total_messages:
          type: integer
          format: int64
          minimum: 0
        pass_messages:
          type: integer
          format: int64
          minimum: 0
        fail_messages:
          type: integer
          format: int64
          minimum: 0
        dkim_pass_messages:
          type: integer
          format: int64
          minimum: 0
        dkim_fail_messages:
          type: integer
          format: int64
          minimum: 0
        spf_pass_messages:
          type: integer
          format: int64
          minimum: 0
        spf_fail_messages:
          type: integer
          format: int64
          minimum: 0
    DmarcSourceMetric:
      type: object
      properties:
        source_key:
          type: string
          example: google-workspace
        source_name:
          type: string
          example: Google Workspace
        source_type:
          type: string
          enum:
            - provider
            - unknown_network
        source_ip:
          type: string
          example: 192.0.2.10
        source_ips:
          type: array
          items:
            type: string
        total_messages:
          type: integer
          format: int64
          minimum: 0
        pass_messages:
          type: integer
          format: int64
          minimum: 0
        fail_messages:
          type: integer
          format: int64
          minimum: 0
        dkim_pass_messages:
          type: integer
          format: int64
          minimum: 0
        dkim_fail_messages:
          type: integer
          format: int64
          minimum: 0
        spf_pass_messages:
          type: integer
          format: int64
          minimum: 0
        spf_fail_messages:
          type: integer
          format: int64
          minimum: 0
        header_from_domains:
          type: array
          items:
            type: string
        dkim_domains:
          type: array
          items:
            type: string
        spf_domains:
          type: array
          items:
            type: string
        status:
          type: string
          enum:
            - healthy
            - needs_attention
            - unreviewed
        recommendation:
          type: string
    DmarcPolicyMetric:
      type: object
      properties:
        policy_domain:
          type: string
          format: hostname
        policy_p:
          type: string
        policy_sp:
          type: string
        policy_np:
          type: string
        policy_adkim:
          type: string
        policy_aspf:
          type: string
        policy_pct:
          type: integer
          minimum: 0
          maximum: 100
        received_at:
          type: integer
          format: int64
          description: Unix milliseconds.
    DmarcError:
      type: object
      required:
        - error
      properties:
        success:
          type: boolean
          example: false
        error:
          type: string
          example: Invalid domain
        code:
          type: string
          example: invalid_domain
        details:
          type: string
  securitySchemes:
    apiKeyAuth:
      type: http
      scheme: bearer
      description: API key for account management endpoints. Use your api_ prefixed token.

````