---
title: "Grafana Cloud Synthetic Monitoring REST API | Grafana Cloud documentation"
description: "Find the Synthetic Monitoring REST API reference, generate an access token, locate your backend address, and authenticate requests to manage checks and probes programmatically."
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# Grafana Cloud Synthetic Monitoring REST API

The Grafana Cloud Synthetic Monitoring REST API provides programmatic access to Synthetic Monitoring resources.

## Authentication and authorization

To authenticate with the Grafana Cloud Synthetic Monitoring API, you need the following:

- A Synthetic Monitoring access token
- Your Synthetic Monitoring backend address

### Get a Synthetic Monitoring access token

To generate an access token:

1. Log in to your Grafana Cloud account.
2. Go to **Testing & synthetics > Synthetics > Config**.
3. Click the [**Access tokens**](https://grafana.com/launch/a/grafana-synthetic-monitoring-app/config/access-tokens) tab.
4. Click **Generate access token**.
5. Copy and save your access token.

### Get your Synthetic Monitoring backend address

To find your backend address:

1. Log in to your Grafana Cloud account.
2. Go to **Testing & synthetics > Synthetics > Config**.
3. On the [**General**](https://grafana.com/launch/a/grafana-synthetic-monitoring-app/config/) tab, copy the URL address under “Your backend address is”. For example: `synthetic-monitoring-api-us-east-0.grafana.net`.

### Example request

Include the access token in the `Authorization` header and replace the backend address for all requests to the API. The following example lists all checks:

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

```http
GET https://@@@SM_BACKEND_ADDRESS@@@/api/v1/check
Authorization: Bearer @@@SM_ACCESS_TOKEN@@@
```

## API reference

View the complete [Synthetic Monitoring API reference](https://synthetic-monitoring-api.grafana.net/api/v1/swagger).

Download the [OpenAPI specification file](https://synthetic-monitoring-api.grafana.net/api/v1/openapi).