---
title: "Cloud REST API | Grafana Cloud documentation"
description: "Grafana Cloud k6 REST API The Grafana Cloud k6 REST API provides programmatic access to Grafana Cloud k6 resources. Authentication and authorization To authenticate with the Grafana Cloud k6 HTTP API, you’ll need:"
---

# Grafana Cloud k6 REST API

The Grafana Cloud k6 REST API provides programmatic access to Grafana Cloud k6 resources.

## Authentication and authorization

To authenticate with the Grafana Cloud k6 HTTP API, you’ll need:

- A Personal API token or a Grafana Stack API token. Refer to [Authenticate on the CLI](/docs/grafana-cloud/testing/k6/author-run/tokens-and-cli-authentication/) to learn how to get a token.
- A Grafana stack instance ID that can be retrieved in **Testing & synthetics** -> **Performance** -> **Settings** -> **Stack ID**.

> Note
> 
> Refer to [Your Grafana Cloud Stack](/docs/grafana-cloud/security-and-account-management/cloud-stacks/) to learn alternative ways of getting your stack instance ID.

Include the API token in the `Authorization` header and the instance ID in the `X-Stack-Id` header for all requests to the API. For example:

HTTP ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```http
GET https://api.k6.io/cloud/v6/projects
Authorization: Bearer 56c166885f9a7fc1e579a1b3cb66f6dd
X-Stack-Id: 12345
```

## HTTP APIs

### Cloud resources

- [Projects](/docs/grafana-cloud/testing/k6/reference/cloud-rest-api/projects/)
- [Load tests](/docs/grafana-cloud/testing/k6/reference/cloud-rest-api/load-tests/)
- [Test runs](/docs/grafana-cloud/testing/k6/reference/cloud-rest-api/test-runs/)
- [Schedules](/docs/grafana-cloud/testing/k6/reference/cloud-rest-api/schedules/)
- [Load zones](/docs/grafana-cloud/testing/k6/reference/cloud-rest-api/load-zones/)
- [Authorization](/docs/grafana-cloud/testing/k6/reference/cloud-rest-api/authorization/)

> Note
> 
> You can download the OpenAPI specification file for the cloud resource endpoints [here](https://editor-next.swagger.io/?url=https%3A%2F%2Fapi.k6.io%2Fcloud%2Fv6%2Fopenapi).

### Metrics

- [Metrics](/docs/grafana-cloud/testing/k6/reference/cloud-rest-api/metrics/)