> ## 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.

# List DMARC aggregate reports

> Returns paginated aggregate-report summaries from the account regional log store. The default order is newest first.



## OpenAPI

````yaml /openapi.json get /dmarc/reports
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/reports:
    get:
      tags:
        - DMARC
      summary: List DMARC aggregate reports
      description: >-
        Returns paginated aggregate-report summaries from the account regional
        log store. The default order is newest first.
      parameters:
        - name: domain_uuid
          in: query
          required: false
          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
            maximum: 4102444800
        - name: date_to
          in: query
          required: false
          description: Inclusive interval end as Unix seconds. Defaults to now.
          schema:
            type: integer
            format: int64
            minimum: 0
            maximum: 4102444800
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 500
            default: 100
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            maximum: 10000000
            default: 0
        - name: sort_order
          in: query
          required: false
          schema:
            type: string
            enum:
              - asc
              - desc
            default: desc
      responses:
        '200':
          description: Paginated DMARC aggregate reports
          content:
            application/json:
              schema:
                type: object
                required:
                  - reports
                  - total
                properties:
                  reports:
                    type: array
                    items:
                      $ref: '#/components/schemas/DmarcReportSummary'
                  total:
                    type: integer
                    format: int64
                    minimum: 0
        '400':
          description: Invalid domain UUID, date range, or pagination
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DmarcError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DmarcError'
        '503':
          description: Regional DMARC report service is unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DmarcError'
components:
  schemas:
    DmarcReportSummary:
      type: object
      required:
        - report_key
        - domain_uuid
        - policy_domain
        - schema_version
        - reporter_org_name
        - reporter_email
        - external_report_id
        - report_begin
        - report_end
        - policy_p
        - policy_sp
        - policy_np
        - policy_adkim
        - policy_aspf
        - policy_pct
        - record_count
        - total_messages
        - pass_messages
        - fail_messages
        - disposition_none
        - disposition_quarantine
        - disposition_reject
        - received_at
      properties:
        report_key:
          type: string
          pattern: ^[0-9a-f]{64}$
          description: Stable SHA-256 identifier for the normalized aggregate report.
        domain_uuid:
          type: string
          format: uuid
        policy_domain:
          type: string
          format: hostname
          example: example.com
        schema_version:
          type: string
          example: '1.0'
        reporter_org_name:
          type: string
          example: Google Inc.
        reporter_email:
          type: string
          example: noreply-dmarc-support@google.com
        external_report_id:
          type: string
          example: '1234567890123456789'
        report_begin:
          type: integer
          format: int64
          description: Beginning of the report interval as Unix seconds.
        report_end:
          type: integer
          format: int64
          description: End of the report interval as Unix seconds.
        policy_p:
          type: string
          example: reject
        policy_sp:
          type: string
          example: reject
        policy_np:
          type: string
          example: reject
        policy_adkim:
          type: string
          example: r
        policy_aspf:
          type: string
          example: r
        policy_pct:
          type: integer
          minimum: 0
          maximum: 100
          example: 100
        record_count:
          type: integer
          format: int32
          minimum: 0
          example: 12
        total_messages:
          type: integer
          format: int64
          minimum: 0
          example: 1842
        pass_messages:
          type: integer
          format: int64
          minimum: 0
          example: 1800
        fail_messages:
          type: integer
          format: int64
          minimum: 0
          example: 42
        disposition_none:
          type: integer
          format: int64
          minimum: 0
          example: 1800
        disposition_quarantine:
          type: integer
          format: int64
          minimum: 0
          example: 12
        disposition_reject:
          type: integer
          format: int64
          minimum: 0
          example: 30
        received_at:
          type: integer
          format: int64
          description: Time the aggregate email was received as 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.

````