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

# List all scores

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

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/scorecard/scores/{aggregation}`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `apm_service_catalog_read`

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/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)