# reports_orgs_retrieve

Lists all available reports in the system.

This endpoint returns a list of all reports available to the user, including:
- Report metadata (name, description, icon)
- Available query parameters for each report
- Result columns that will be returned
- Current status of any previously requested reports

If a report has been previously requested by the user, its status will be included
in the response. Expired reports are automatically cleaned up.

Returns:
    A list of report objects with their metadata and status information.

Endpoint: GET /api/reports/orgs/{org}/
Version: 3.59.0-ai-plus
Security: PlatformApiKeyAuthentication

## Path parameters:

  - `org` (string, required)

## Response 200 fields (application/json):

  - `data` (array, required)

  - `data.display_name` (string)
    Report Name

  - `data.description` (string)
    Report Description

  - `data.report_name` (string)
    Report slug

  - `data.icon` (string)

  - `data.extra_query_params` (array)
    Extra parameters to be passed to the report create view, e.g learner_id

  - `data.result_columns` (array)
    Columns to be available in the report

  - `data.status` (object)
    Report Status if any available

  - `data.status.report_id` (string)
    Used to download the report

  - `data.status.report_name` (string)
    Report slug, this is passed when calling the create report endpoint

  - `data.status.state` (string)
    Report States

*  - Pending
*  - Running
*  - Accumulating
*  - Processing
*  - Storing
*  - Completed
*  - Cancelled
*  - Error
*  - Expired
    Enum: "pending", "running", "accumulating", "processing", "storing", "completed", "cancelled", "error", "expired"

  - `data.status.started_on` (string)
    Report request timestamp (ISO 8601)

  - `data.status.owner` (string)
    Report Owner

  - `data.status.expires` (string)
    When report would expire and not available for download anymore

  - `data.status.url` (string)
    Download link for report when available