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

# List all rule outcomes

`GET /api/v2/scorecard/outcomes`

## Request

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

## Query parameters

- `page[size]` integer
- `page[offset]` integer
- `include` string
- `fields[outcome]` string
- `fields[rule]` string
- `filter[outcome][service_name]` string
- `filter[outcome][state]` string
- `filter[rule][enabled]` boolean
- `filter[rule][id]` string
- `filter[rule][name]` string

## Response `200`

OK

- OutcomesResponse: Scorecard outcomes - the result of a rule for a service.
  - `data` OutcomesResponseDataItem[]: List of rule outcomes.
    - `attributes` OutcomesBatchResponseAttributes: The JSON:API attributes for an outcome.
      - `created_at` string, date-time: Creation time of the rule outcome.
      - `modified_at` string, date-time: Time of last rule outcome modification.
      - `remarks` string: Any remarks regarding the scorecard rule's evaluation, and supports HTML hyperlinks.
      - `service_name` string: The unique name for a service in the catalog.
      - `state` 'pass' | 'fail' | 'skip': The state of the rule evaluation.
    - `id` string: The unique ID for a rule outcome.
    - `relationships` RuleOutcomeRelationships: The JSON:API relationship to a scorecard rule.
      - `rule` RelationshipToOutcome: The JSON:API relationship to a scorecard outcome.
        - `data` RelationshipToOutcomeData: The JSON:API relationship to an outcome, which returns the related rule id.
          - `id` string: The unique ID for a scorecard rule.
          - `type` 'rule': The JSON:API type for scorecard rules.
    - `type` 'outcome': The JSON:API type for an outcome.
  - `included` OutcomesResponseIncludedItem[]: Array of rule details.
    - `attributes` OutcomesResponseIncludedRuleAttributes: Details of a rule.
      - `name` string: Name of the rule.
      - `scorecard_name` string: The scorecard name to which this rule must belong.
    - `id` string: The unique ID for a scorecard rule.
    - `type` 'rule': The JSON:API type for scorecard rules.
  - `links` OutcomesResponseLinks: Links attributes.
    - `next` string: Link for the next set 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)