---
title: "Gets all correlations."
method: GET
path: "/datasources/correlations"
tags: ["datasources", "correlations"]
---

# Gets all correlations.

`GET /datasources/correlations`

## Request

- Base URL: `/api` (relative, and the document’s source URL is not known)
- URL: `/api/datasources/correlations`
- Auth: one of:
  - HTTP basic
  - API key in header `Authorization`

## Query parameters

- `limit` integer
- `page` integer
- `sourceUID` string[]

## Response `200`

(empty)

- Correlation[]
  - `config` CorrelationConfig
    - `field` string, required: Field used to attach the correlation link
    - `target` object, required: Target data query
    - `transformations` Transformation[]
      - `expression` string
      - `field` string
      - `mapValue` string
      - `type` 'regex' | 'logfmt'
    - `type` string: the type of correlation, either query for containing query information, or external for containing an external URL +enum
  - `description` string: Description of the correlation
  - `label` string: Label identifying the correlation
  - `orgId` integer: OrgID of the data source the correlation originates from
  - `provisioned` boolean: Provisioned True if the correlation was created during provisioning
  - `sourceUID` string: UID of the data source the correlation originates from
  - `targetUID` string: UID of the data source the correlation points to
  - `type` string: the type of correlation, either query for containing query information, or external for containing an external URL +enum
  - `uid` string: Unique identifier of the correlation

## Other responses

- `401`: UnauthorizedError is returned when the request is not authenticated.
- `404`: NotFoundError is returned when the requested resource was not found.
- `500`: InternalServerError is a general error indicating something went wrong internally.

---

[API](https://skmtc.dev/grafana/apis/grafana-http-api.md) - [All operations](https://skmtc.dev/grafana/apis/grafana-http-api/llms.txt) - [OpenAPI document](https://skmtc.dev/grafana/apis/grafana-http-api/revisions/df55ba1718ba?raw)