---
title: "List reports."
method: GET
path: "/reports"
tags: ["reports", "enterprise"]
---

# List reports.

`GET /reports`

Available to org admins only and with a valid or expired license.

You need to have a permission with action `reports:read` with scope `reports:*`.

## Response `200`

(empty)

- ConfigDTO[]
  - `created` string, date-time
  - `dashboardId` integer
  - `dashboardName` string
  - `dashboardUid` string
  - `dashboards` DashboardDTO[]
    - `dashboard` DashboardReportDTO
      - `id` integer
      - `name` string
      - `uid` string
    - `reportVariables` object
    - `timeRange` TimeRangeDTO
      - `from` string
      - `to` string
  - `enableCsv` boolean
  - `enableDashboardUrl` boolean
  - `formats` Type[]
  - `id` integer
  - `message` string
  - `name` string
  - `options` ReportOptionsDTO
    - `layout` string
    - `orientation` string
    - `timeRange` TimeRangeDTO
      - `from` string
      - `to` string
  - `orgId` integer
  - `recipients` string
  - `replyTo` string
  - `scaleFactor` integer
  - `schedule` ScheduleDTO
    - `day` string
    - `dayOfMonth` string
    - `endDate` string, date-time
    - `frequency` string
    - `hour` integer
    - `intervalAmount` integer
    - `intervalFrequency` string
    - `minute` integer
    - `startDate` string, date-time
    - `timeZone` string
    - `workdaysOnly` boolean
  - `state` string
  - `templateVars` object
  - `updated` string, date-time
  - `userId` integer

## Other responses

- `401` — UnauthorizedError is returned when the request is not authenticated.
- `403` — ForbiddenError is returned if the user/token has insufficient permissions to access the requested resource.
- `500` — InternalServerError is a general error indicating something went wrong internally.

---

[API](https://skmtc.net/nforgeio/apis/grafana-http-api.md) · [All operations](https://skmtc.net/nforgeio/apis/grafana-http-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nforgeio/grafana-http-api/versions/3cb6c3f42dc7/schema)