# Grafana Reports API

**Canonical:** https://apis.io/apis/grafana-com/grafana-com-reports-api/  
**Provider:** Grafana — https://apis.io/providers/grafana-com/  
**Base URL:** /api  
**Documentation:** https://grafana.com/docs/grafana/latest/developers/http_api/

Grafana Reports API is one of 49 APIs that [Grafana](https://apis.io/providers/grafana-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Reports. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and authentication docs.

This API allows you to interact programmatically with the Reporting feature. Reporting is only available in Grafana Enterprise. Read more about Grafana Enterprise. If you have Fine-grained access Control enabled, for some endpoints you would need to have relevant permissions. Refer to specific resources to understand what permissions are required.

## Operations (13)

| Method | Path | Summary |
|---|---|---|
| GET | `/reports` | List reports |
| POST | `/reports` | Create a report |
| GET | `/reports/dashboards/{uid}` | List reports by dashboard uid |
| POST | `/reports/email` | Send a report |
| GET | `/reports/images/:image` | Get custom branding report image |
| GET | `/reports/render/csvs` | Download a CSV report |
| GET | `/reports/render/pdfs` | Render report for multiple dashboards |
| GET | `/reports/settings` | Get report settings |
| POST | `/reports/settings` | Save settings |
| POST | `/reports/test-email` | Send test report via email |
| GET | `/reports/{id}` | Get a report |
| PUT | `/reports/{id}` | Update a report |
| DELETE | `/reports/{id}` | Delete a report |

## Machine-readable artifacts (32)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/grafana-com/refs/heads/main/openapi/grafana-com-reports-api-openapi.yml
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/
- **Authentication** — https://grafana.com/docs/grafana/latest/developers/http_api/authentication/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/dashboard/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/dashboard_versions/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/dashboard_permissions/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/dashboard_public/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/folder/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/folder_dashboard_search/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/folder_permissions/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/data_source/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/datasource_permissions/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/datasource_lbac_rules/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/alerting_provisioning/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/annotations/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/org/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/user/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/team/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/team_sync/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/preferences/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/access_control/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/serviceaccount/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/sso-settings/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/admin/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/licensing/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/reporting/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/query_and_resource_caching/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/library_element/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/correlations/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/snapshot/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/short_url/
- **Documentation** — https://grafana.com/docs/grafana/latest/developers/http_api/query_history/

## Other Grafana APIs (12)

- [Grafana Cloud API](https://apis.io/apis/grafana-com/grafana-cloud-api/)
- [Grafana Loki HTTP API](https://apis.io/apis/grafana-com/loki-http-api/)
- [Grafana Mimir HTTP API](https://apis.io/apis/grafana-com/mimir-http-api/)
- [Grafana Tempo HTTP API](https://apis.io/apis/grafana-com/tempo-http-api/)
- [Grafana Pyroscope HTTP API](https://apis.io/apis/grafana-com/pyroscope-http-api/)
- [Grafana k6 Cloud API](https://apis.io/apis/grafana-com/k6-cloud-api/)
- [Grafana OnCall API](https://apis.io/apis/grafana-com/oncall-api/)
- [Grafana Synthetic Monitoring API](https://apis.io/apis/grafana-com/synthetic-monitoring-api/)
- [Grafana Access Control API](https://apis.io/apis/grafana-com/grafana-com-access-control-api/)
- [Grafana Admin API](https://apis.io/apis/grafana-com/grafana-com-admin-api/)
- [Grafana Admin Ldap API](https://apis.io/apis/grafana-com/grafana-com-admin-ldap-api/)
- [Grafana Admin Provisioning API](https://apis.io/apis/grafana-com/grafana-com-admin-provisioning-api/)

## Tags

Reports

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/grafana-com/grafana-com-reports-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/grafana-com/.