---
title: "List all scorecards"
method: GET
path: "/api/v2/scorecard/scorecards"
tags: ["Scorecards"]
---

# List all scorecards

`GET /api/v2/scorecard/scorecards`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/scorecard/scorecards`
- 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`

Fetches all scorecards.

## Query parameters

- `page[offset]` integer
- `page[size]` integer
- `filter[scorecard][id]` string
- `filter[scorecard][name]` string
- `filter[scorecard][description]` string

## Response `200`

OK

- ListScorecardsResponse: Response containing a list of scorecards.
  - `data` ScorecardListResponseData[], required: Array of scorecards.
    - `attributes` ScorecardListResponseAttributes, required: Scorecard attributes.
      - `created_at` string, date-time, required: Creation time of the scorecard.
      - `description` string: The description of the scorecard.
      - `modified_at` string, date-time, required: Time of last scorecard modification.
      - `name` string, required: The name of the scorecard.
    - `id` string, required: The unique ID of the scorecard.
    - `type` 'scorecard', required: The JSON:API type for scorecard list.

## Other responses

- `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)