---
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)

- Report[]
  - `created` string, date-time
  - `dashboards` ReportDashboard[]
    - `dashboard` ReportDashboardID
      - `id` integer
      - `name` string
      - `uid` string
    - `reportVariables` object
    - `timeRange` ReportTimeRange
      - `from` string
      - `to` string
  - `enableCsv` boolean
  - `enableDashboardUrl` boolean
  - `formats` Type[]
  - `id` integer
  - `message` string
  - `name` string
  - `options` ReportOptions
    - `csvEncoding` string
    - `layout` string
    - `orientation` string
    - `pdfCombineOneFile` boolean
    - `pdfShowTemplateVariables` boolean
    - `timeRange` ReportTimeRange
      - `from` string
      - `to` string
  - `orgId` integer
  - `recipients` string
  - `replyTo` string
  - `scaleFactor` integer
  - `schedule` ReportSchedule
    - `dayOfMonth` string
    - `endDate` string, date-time
    - `frequency` string
    - `intervalAmount` integer
    - `intervalFrequency` string
    - `startDate` string, date-time
    - `timeZone` string
    - `workdaysOnly` boolean
  - `state` string — +enum
  - `subject` string
  - `uid` string
  - `updated` string, date-time
  - `urls` ReportURLItem[]
    - `title` string
    - `url` string
  - `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/grafana/apis/http-api.md) · [All operations](https://skmtc.net/grafana/apis/http-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/grafana/http-api/versions/df55ba1718ba/schema)