Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

DocumentationGrafana documentationDevelopersHTTP APIcURL examples

cURL examples

This page provides examples of calls to the Grafana API using cURL.

The most basic example for a dashboard for which there is no authentication. You can test the following on your local machine, assuming a default installation and anonymous access enabled, required:

Copy

curl http://localhost:3000/api/search

Here’s a cURL command that works for getting the home dashboard when you are running Grafana locally with basic authentication enabled using the default admin credentials:

Copy

curl http://admin:admin@localhost:3000/api/search

To pass a username and password with HTTP basic authorization, encode them as base64. You can’t use authorization tokens in the request.

For example, to list permissions associated with roles given a username of user and password of password, use:

Copy

curl --location --request GET '<grafana_url>/api/access-control/builtin-roles' --header 'Authorization: Basic dXNlcjpwYXNzd29yZAo='

where dXNlcjpwYXNzd29yZAo= is the base64 encoding of user:password.