---
title: "List Metric Groups"
method: GET
path: "/projects/{projectId}/metric-groups"
---

# List Metric Groups

`GET /projects/{projectId}/metric-groups`

## Request

- Base URL: `https://api2.scorecard.io/api/v2`
- URL: `https://api2.scorecard.io/api/v2/projects/{projectId}/metric-groups`
- Auth: HTTP bearer

List Metric Groups configured for the specified Project. Metric Groups are returned in reverse chronological order.

## Path parameters

- `projectId` string, required

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Successfully retrieved Metric Groups.

- object
  - `data` MetricGroup[], required
    - `id` string, required: The ID of the Metric Group.
    - `projectId` string, required: The ID of the Project the Metric Group belongs to.
    - `name` string, required: The name of the Metric Group.
    - `description` string, required: The description of the Metric Group.
    - `metricIds` string[], required: The IDs of the Metrics in the group.
    - `createdAt` string, required: The ISO 8601 timestamp when the Metric Group was created.
    - `updatedAt` string, required: The ISO 8601 timestamp when the Metric Group was last updated.
  - `nextCursor` string, nullable, required
  - `hasMore` boolean, required
  - `total` integer

## Other responses

- `401`: Error indicating that the request is not authenticated.
- `500`: An internal service error indicating an issue with the Scorecard service.

## Changes

- **2026-09-22** `aea3bbdea11d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/scorecard-ai/apis/scorecard-api/changes/projects/:projectId/metric-groups/get.md)

---

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