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

# List mailback report requests

> The tenant's report requests for the source, newest first, made on demand or by the schedule.



## OpenAPI

````yaml /openapi.yaml get /api/mailback-automation/v1/sources/{source}/requests
openapi: 3.0.3
info:
  title: MF Atlas API
  version: 1.0.0
servers:
  - description: Sandbox
    url: https://api-sandbox.mf-atlas.space
  - description: Production
    url: https://api.mf-atlas.space
security:
  - bearerAuth: []
paths:
  /api/mailback-automation/v1/sources/{source}/requests:
    get:
      tags:
        - mailback-automation
      summary: List mailback report requests
      description: >-
        The tenant's report requests for the source, newest first, made on
        demand or by the schedule.
      parameters:
        - description: Report source. Only cams today.
          in: path
          name: source
          required: true
          schema:
            type: string
        - description: Page size (default 25, max 100).
          in: query
          name: limit
          required: false
          schema:
            type: string
        - description: next_cursor from the previous page.
          in: query
          name: cursor
          required: false
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    items:
                      properties:
                        created_at:
                          type: string
                        error:
                          type: string
                        id:
                          type: string
                        report:
                          type: string
                        source:
                          type: string
                        status:
                          description: >-
                            QUEUED (handed to the automation queue; the report
                            itself arrives by email) or FAILED (could not be
                            queued).
                          type: string
                        timing:
                          type: string
                        trigger:
                          description: ON_DEMAND or SCHEDULED.
                          type: string
                      required:
                        - created_at
                        - id
                        - report
                        - source
                        - status
                        - timing
                        - trigger
                      type: object
                    type: array
                  next_cursor:
                    type: string
                  success:
                    type: boolean
                required:
                  - success
                type: object
          description: Requests
components:
  securitySchemes:
    bearerAuth:
      bearerFormat: Opaque bearer token from POST /api/auth/v1/token
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.