DevelopersHTTP 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:

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:

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:

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

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