---
title: "List all scores"
method: GET
path: "/api/v2/scorecard/scores/{aggregation}"
tags: ["Scorecards"]
---

# List all scores

`GET /api/v2/scorecard/scores/{aggregation}`

Returns a list of scorecard scores for each aggregation type, with score breakdowns.

## Path parameters

- `aggregation` 'by-entity' | 'by-rule' | 'by-scorecard' | 'by-team' | 'by-kind', required — Dimension to group scores by.

## Query parameters

- `filter[rule][id]` string
- `filter[rule][name]` string
- `filter[rule][level]` string
- `filter[rule][scorecard_id]` string
- `filter[rule][is_custom]` boolean
- `filter[rule][is_enabled]` boolean
- `sort` string
- `page[offset]` integer
- `page[limit]` integer

## Response `200`

OK

- ListScorecardScoresResponse — A list of scorecard scores for a given aggregation type.
  - `data` ScorecardScoreData[] — Array of score objects.
    - `attributes` ScorecardScoreAttributes — Attributes of a scorecard score.
      - `aggregation` 'by-entity' | 'by-rule' | 'by-scorecard' | 'by-team' | 'by-kind' — Dimension to group scores by.
      - `denominator` integer — The denominator used to compute the score ratio.
      - `level` integer — The maturity level of the associated rule.
      - `numerator` integer — The numerator used to compute the score ratio.
      - `score` number, double — The computed score ratio (numerator/denominator), from 0 to 1.
      - `total_entities` integer — The total number of entities evaluated.
      - `total_fail` integer — The number of rules that failed.
      - `total_no_data` integer — The number of rules with no data.
      - `total_pass` integer — The number of rules that passed.
      - `total_skip` integer — The number of rules that were skipped.
    - `id` string, required — The ID of the entity or resource being scored.
    - `relationships` ScorecardScoreRelationships — Relationships for a scorecard score, depending on the aggregation type.
      - `entity` ScorecardScoreRelationshipItem — A relationship item for a score.
        - `data` ScorecardScoreRelationshipData — A relationship data object for a score.
          - `id` string, required — The ID of the related resource.
          - `type` string, required — The type of the related resource.
      - `rule` ScorecardScoreRelationshipItem — A relationship item for a score.
        - `data` ScorecardScoreRelationshipData — A relationship data object for a score.
          - `id` string, required — The ID of the related resource.
          - `type` string, required — The type of the related resource.
      - `scorecard` ScorecardScoreRelationshipItem — A relationship item for a score.
        - `data` ScorecardScoreRelationshipData — A relationship data object for a score.
          - `id` string, required — The ID of the related resource.
          - `type` string, required — The type of the related resource.
      - `service` ScorecardScoreRelationshipItem — A relationship item for a score.
        - `data` ScorecardScoreRelationshipData — A relationship data object for a score.
          - `id` string, required — The ID of the related resource.
          - `type` string, required — The type of the related resource.
      - `team` ScorecardScoreRelationshipItem — A relationship item for a score.
        - `data` ScorecardScoreRelationshipData — A relationship data object for a score.
          - `id` string, required — The ID of the related resource.
          - `type` string, required — The type of the related resource.
    - `type` 'score', required — The JSON:API resource type.
  - `links` ListRulesResponseLinks — Links attributes.
    - `next` string — Link for the next set of rules.
  - `meta` ListScorecardScoresMeta — Pagination metadata for scores.
    - `count` integer — The number of results returned in this page.
    - `limit` integer — The page limit.
    - `offset` integer — The page offset.
    - `total` integer — The total number of results.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `429` — Too many requests

---

[API](https://skmtc.dev/datadog/apis/api-v2.md) · [All operations](https://skmtc.dev/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)