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

# List reports



## OpenAPI

````yaml post /v1/report/list
openapi: 3.0.0
info:
  title: Report APIs Specification
  description: Section for description
  version: '1.0'
  contact: {}
servers:
  - url: https://staging.api.us.aptlydone.com/report
  - url: https://staging.api.eu.aptlydone.com/report
  - url: https://api.us.aptlydone.com/report
  - url: https://api.eu.aptlydone.com/report
security: []
tags: []
paths:
  /v1/report/list:
    post:
      tags:
        - report
      summary: List reports
      operationId: ReportController_getReportsList_v1
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReportListDto'
      responses:
        '201':
          description: Report list retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReportListResponseDtoResponse'
      security:
        - accessToken: []
components:
  schemas:
    ReportListDto:
      type: object
      properties:
        page:
          type: number
          description: Page number
          example: 1
        limit:
          type: number
          description: Page size
          example: 10
        tenantId:
          type: string
          format: uuid
          description: >-
            Tenant ID (optional, will use auth user active tenant if not
            provided)
          example: 89f78ee4-8fba-4356-b067-751f47fd08dc
        search:
          type: string
          description: Search keyword
          example: budget
        ownerId:
          description: Owner ID
          type: array
          items:
            type: string
            format: uuid
        reportType:
          type: array
          description: Report types
          items:
            type: string
            enum:
              - DECISIONS
              - DELEGATIONS
              - ACTIONS
              - DOCUMENTS
              - USERS
              - POSITIONS
              - GROUPS
              - MATRICES
        reportStatus:
          type: array
          description: Report statuses
          items:
            type: string
            enum:
              - PUBLISHED
              - ARCHIVED
              - DELETED
              - DRAFT
        sortBy:
          type: string
          description: Sort by field
          example: createdAt
        sortOrder:
          type: object
          description: Sort order
          example: DESC
        startDate:
          type: string
          description: Start date filter
          example: '2024-01-01T00:00:00.000Z'
        endDate:
          type: string
          description: End date filter
          example: '2024-12-31T23:59:59.999Z'
    ReportListResponseDtoResponse:
      type: object
      properties:
        statusCode:
          type: number
          description: HTTP Status code
          example: 200
        timestamp:
          type: string
          description: Timestamp of the response
          example: '2026-01-08T06:33:03.221Z'
        message:
          type: string
          description: Response message
          example: Success
        data:
          description: Response data
          allOf:
            - $ref: '#/components/schemas/ReportListResponseDto'
      required:
        - statusCode
        - timestamp
        - message
        - data
    ReportListResponseDto:
      type: object
      properties:
        statusCounts:
          description: Counts of reports by status
          allOf:
            - $ref: '#/components/schemas/ReportStatusCountsDto'
        reports:
          description: Counts of reports by status
          allOf:
            - $ref: '#/components/schemas/PaginatedData'
      required:
        - statusCounts
        - reports
    ReportStatusCountsDto:
      type: object
      properties:
        published:
          type: number
          description: Count of published reports
          example: 31
        draft:
          type: number
          description: Count of draft reports
          example: 4
        archived:
          type: number
          description: Count of archived reports
          example: 4
        all:
          type: number
          description: Total count of all reports (excluding deleted)
          example: 39
      required:
        - published
        - draft
        - archived
        - all
    PaginatedData:
      type: object
      properties:
        page:
          type: number
          description: Current page number
          example: 1
          minimum: 1
        limit:
          type: number
          description: Number of items per page
          example: 10
          minimum: 1
        total:
          type: number
          description: Total number of items
          example: 100
          minimum: 0
        data:
          description: Array of items
          type: array
          items:
            type: array
      required:
        - page
        - limit
        - total
        - data
  securitySchemes:
    accessToken:
      scheme: bearer
      bearerFormat: JWT
      type: http

````