---
title: Scorecards
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > API Reference > Scorecards
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Scorecards

API to create and update scorecard rules and outcomes. See [Scorecards](https://docs.datadoghq.com/service_catalog/scorecards.md) for more information.

## [Create a new rule →](https://docs.datadoghq.com/api/latest/scorecards/create-a-new-rule.md){% #create-a-new-rule %}

| Datadog site      | API endpoint                                              |
| ----------------- | --------------------------------------------------------- |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/scorecard/rules |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/scorecard/rules |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/scorecard/rules      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/scorecard/rules      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/scorecard/rules  |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/scorecard/rules |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/scorecard/rules     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/scorecard/rules |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/scorecard/rules |

## [Update an existing scorecard rule →](https://docs.datadoghq.com/api/latest/scorecards/update-an-existing-scorecard-rule.md){% #update-an-existing-scorecard-rule %}

| Datadog site      | API endpoint                                                       |
| ----------------- | ------------------------------------------------------------------ |
| ap1.datadoghq.com | PUT https://api.ap1.datadoghq.com/api/v2/scorecard/rules/{rule_id} |
| ap2.datadoghq.com | PUT https://api.ap2.datadoghq.com/api/v2/scorecard/rules/{rule_id} |
| app.datadoghq.eu  | PUT https://api.datadoghq.eu/api/v2/scorecard/rules/{rule_id}      |
| app.ddog-gov.com  | PUT https://api.ddog-gov.com/api/v2/scorecard/rules/{rule_id}      |
| us2.ddog-gov.com  | PUT https://api.us2.ddog-gov.com/api/v2/scorecard/rules/{rule_id}  |
| uk1.datadoghq.com | PUT https://api.uk1.datadoghq.com/api/v2/scorecard/rules/{rule_id} |
| app.datadoghq.com | PUT https://api.datadoghq.com/api/v2/scorecard/rules/{rule_id}     |
| us3.datadoghq.com | PUT https://api.us3.datadoghq.com/api/v2/scorecard/rules/{rule_id} |
| us5.datadoghq.com | PUT https://api.us5.datadoghq.com/api/v2/scorecard/rules/{rule_id} |

## [Update Scorecard outcomes →](https://docs.datadoghq.com/api/latest/scorecards/update-scorecard-outcomes.md){% #update-scorecard-outcomes %}

| Datadog site      | API endpoint                                                 |
| ----------------- | ------------------------------------------------------------ |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/scorecard/outcomes |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/scorecard/outcomes |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/scorecard/outcomes      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/scorecard/outcomes      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/scorecard/outcomes  |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/scorecard/outcomes |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/scorecard/outcomes     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/scorecard/outcomes |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/scorecard/outcomes |

## [List all rule outcomes →](https://docs.datadoghq.com/api/latest/scorecards/list-all-rule-outcomes.md){% #list-all-rule-outcomes %}

| Datadog site      | API endpoint                                                |
| ----------------- | ----------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/scorecard/outcomes |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/scorecard/outcomes |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/scorecard/outcomes      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/scorecard/outcomes      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/scorecard/outcomes  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/scorecard/outcomes |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/scorecard/outcomes     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/scorecard/outcomes |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/scorecard/outcomes |

## [List all rules →](https://docs.datadoghq.com/api/latest/scorecards/list-all-rules.md){% #list-all-rules %}

| Datadog site      | API endpoint                                             |
| ----------------- | -------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/scorecard/rules |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/scorecard/rules |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/scorecard/rules      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/scorecard/rules      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/scorecard/rules  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/scorecard/rules |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/scorecard/rules     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/scorecard/rules |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/scorecard/rules |

## [Delete a rule →](https://docs.datadoghq.com/api/latest/scorecards/delete-a-rule.md){% #delete-a-rule %}

| Datadog site      | API endpoint                                                          |
| ----------------- | --------------------------------------------------------------------- |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v2/scorecard/rules/{rule_id} |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v2/scorecard/rules/{rule_id} |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v2/scorecard/rules/{rule_id}      |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v2/scorecard/rules/{rule_id}      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v2/scorecard/rules/{rule_id}  |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.com/api/v2/scorecard/rules/{rule_id} |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v2/scorecard/rules/{rule_id}     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v2/scorecard/rules/{rule_id} |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v2/scorecard/rules/{rule_id} |

## [Create outcomes batch →](https://docs.datadoghq.com/api/latest/scorecards/create-outcomes-batch.md) deprecated preview{% #create-outcomes-batch %}

| Datadog site      | API endpoint                                                       |
| ----------------- | ------------------------------------------------------------------ |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/scorecard/outcomes/batch |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/scorecard/outcomes/batch |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/scorecard/outcomes/batch      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/scorecard/outcomes/batch      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/scorecard/outcomes/batch  |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/scorecard/outcomes/batch |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/scorecard/outcomes/batch     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/scorecard/outcomes/batch |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/scorecard/outcomes/batch |

## [List all campaigns →](https://docs.datadoghq.com/api/latest/scorecards/list-all-campaigns.md){% #list-all-campaigns %}

| Datadog site      | API endpoint                                                 |
| ----------------- | ------------------------------------------------------------ |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/scorecard/campaigns |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/scorecard/campaigns |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/scorecard/campaigns      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/scorecard/campaigns      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/scorecard/campaigns  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/scorecard/campaigns |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/scorecard/campaigns     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/scorecard/campaigns |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/scorecard/campaigns |

## [Create a new campaign →](https://docs.datadoghq.com/api/latest/scorecards/create-a-new-campaign.md){% #create-a-new-campaign %}

| Datadog site      | API endpoint                                                  |
| ----------------- | ------------------------------------------------------------- |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/scorecard/campaigns |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/scorecard/campaigns |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/scorecard/campaigns      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/scorecard/campaigns      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/scorecard/campaigns  |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/scorecard/campaigns |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/scorecard/campaigns     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/scorecard/campaigns |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/scorecard/campaigns |

## [Get a campaign →](https://docs.datadoghq.com/api/latest/scorecards/get-a-campaign.md){% #get-a-campaign %}

| Datadog site      | API endpoint                                                               |
| ----------------- | -------------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/scorecard/campaigns/{campaign_id} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/scorecard/campaigns/{campaign_id} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/scorecard/campaigns/{campaign_id}      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/scorecard/campaigns/{campaign_id}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/scorecard/campaigns/{campaign_id}  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/scorecard/campaigns/{campaign_id} |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/scorecard/campaigns/{campaign_id}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/scorecard/campaigns/{campaign_id} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/scorecard/campaigns/{campaign_id} |

## [Update a campaign →](https://docs.datadoghq.com/api/latest/scorecards/update-a-campaign.md){% #update-a-campaign %}

| Datadog site      | API endpoint                                                               |
| ----------------- | -------------------------------------------------------------------------- |
| ap1.datadoghq.com | PUT https://api.ap1.datadoghq.com/api/v2/scorecard/campaigns/{campaign_id} |
| ap2.datadoghq.com | PUT https://api.ap2.datadoghq.com/api/v2/scorecard/campaigns/{campaign_id} |
| app.datadoghq.eu  | PUT https://api.datadoghq.eu/api/v2/scorecard/campaigns/{campaign_id}      |
| app.ddog-gov.com  | PUT https://api.ddog-gov.com/api/v2/scorecard/campaigns/{campaign_id}      |
| us2.ddog-gov.com  | PUT https://api.us2.ddog-gov.com/api/v2/scorecard/campaigns/{campaign_id}  |
| uk1.datadoghq.com | PUT https://api.uk1.datadoghq.com/api/v2/scorecard/campaigns/{campaign_id} |
| app.datadoghq.com | PUT https://api.datadoghq.com/api/v2/scorecard/campaigns/{campaign_id}     |
| us3.datadoghq.com | PUT https://api.us3.datadoghq.com/api/v2/scorecard/campaigns/{campaign_id} |
| us5.datadoghq.com | PUT https://api.us5.datadoghq.com/api/v2/scorecard/campaigns/{campaign_id} |

## [Delete a campaign →](https://docs.datadoghq.com/api/latest/scorecards/delete-a-campaign.md){% #delete-a-campaign %}

| Datadog site      | API endpoint                                                                  |
| ----------------- | ----------------------------------------------------------------------------- |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v2/scorecard/campaigns/{campaign_id} |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v2/scorecard/campaigns/{campaign_id} |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v2/scorecard/campaigns/{campaign_id}      |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v2/scorecard/campaigns/{campaign_id}      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v2/scorecard/campaigns/{campaign_id}  |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.com/api/v2/scorecard/campaigns/{campaign_id} |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v2/scorecard/campaigns/{campaign_id}     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v2/scorecard/campaigns/{campaign_id} |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v2/scorecard/campaigns/{campaign_id} |

## [List all scorecards →](https://docs.datadoghq.com/api/latest/scorecards/list-all-scorecards.md){% #list-all-scorecards %}

| Datadog site      | API endpoint                                                  |
| ----------------- | ------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/scorecard/scorecards |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/scorecard/scorecards |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/scorecard/scorecards      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/scorecard/scorecards      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/scorecard/scorecards  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/scorecard/scorecards |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/scorecard/scorecards     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/scorecard/scorecards |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/scorecard/scorecards |

## [List all scores →](https://docs.datadoghq.com/api/latest/scorecards/list-all-scores.md){% #list-all-scores %}

| Datadog site      | API endpoint                                                            |
| ----------------- | ----------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/scorecard/scores/{aggregation} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/scorecard/scores/{aggregation} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/scorecard/scores/{aggregation}      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/scorecard/scores/{aggregation}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/scorecard/scores/{aggregation}  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/scorecard/scores/{aggregation} |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/scorecard/scores/{aggregation}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/scorecard/scores/{aggregation} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/scorecard/scores/{aggregation} |