---
title: "Get consumer version heatmap"
method: GET
path: "/admin/usage/artifacts/{groupId}/{artifactId}/heatmap"
tags: ["Admin"]
---

# Get consumer version heatmap

`GET /admin/usage/artifacts/{groupId}/{artifactId}/heatmap`

## Path parameters

- `groupId` string, required
- `artifactId` string, required

## Response `200`

The consumer version heatmap.

- ConsumerVersionHeatmap
  - `groupId` string, required
  - `artifactId` string, required
  - `versions` string[], required
  - `consumers` ConsumerVersionEntry[], required
    - `clientId` string, required
    - `versions` object
    - `versionsBehind` integer
    - `driftAlert` boolean

## Other responses

- `409` — Common response used when an input conflicts with existing data.
- `500` — Common response for all operations that can fail with an unexpected server error.

---

[API](https://skmtc.net/apicurio/apis/apicurio-registry-api-v3.md) · [All operations](https://skmtc.net/apicurio/apis/apicurio-registry-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/apicurio/apicurio-registry-api-v3/revisions/c39cb56d7dbc/schema)