---
title: Get the impact of an error tracking issue
description: "Get an issue's impact over a time window: its error counts by source, and the users, sessions, accounts, RUM views, and endpoints it affects most."
breadcrumbs: Docs > API > Get the impact of an error tracking issue
---

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

# Get the impact of an error tracking issue

## v2 (latest)

{% alert level="warning" %}
**Note**: This endpoint is in preview and is subject to change.
{% /alert %}

| Datadog site      | API endpoint                                                                     |
| ----------------- | -------------------------------------------------------------------------------- |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/error-tracking/issues/{issue_id}/impact     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/error-tracking/issues/{issue_id}/impact |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/error-tracking/issues/{issue_id}/impact |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/error-tracking/issues/{issue_id}/impact      |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/error-tracking/issues/{issue_id}/impact |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/error-tracking/issues/{issue_id}/impact |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/error-tracking/issues/{issue_id}/impact |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/error-tracking/issues/{issue_id}/impact      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/error-tracking/issues/{issue_id}/impact  |

### Overview

Get an issue's impact over a time window: its error counts by source, and the users, sessions, accounts,
RUM views, and endpoints it affects most.
Returns 403 if the caller lacks the `error_tracking_read` permission or does not have access to the issue's
data.

OAuth apps require the `error_tracking_read` authorization [scope](https://docs.datadoghq.com/api/latest/scopes.md#error-tracking) to access this endpoint.

### Arguments

#### Path Parameters

| Field                 | Type   | Description                  |
| --------------------- | ------ | ---------------------------- |
| issue_id [*required*] | string | The identifier of the issue. |

#### Query Strings

| Field                     | Type    | Description                                                                                                                      |
| ------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------- |
| filter[from] [*required*] | integer | Start of the time window, in milliseconds since the Unix epoch. Must be before `filter[to]`.                                     |
| filter[to] [*required*]   | integer | End of the time window, in milliseconds since the Unix epoch. Use the issue's `last_seen` to end the window at its latest error. |

### Response

{% tabs %}
{% tab label="200" %}
OK

{% tabs %}
{% tab label="Model" %}
Response containing the impact of an error tracking issue.

| Parent field | Field                       | Type     | Description                                                                                                                                                                                                                                                                 |
| ------------ | --------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|              | data [*required*]           | object   | The impact of an issue over the requested time window.                                                                                                                                                                                                                      |
| data         | attributes [*required*]     | object   | The issue's errors in the time window, and the users, sessions, accounts, views, and endpoints they affect.                                                                                                                                                                 |
| attributes   | accounts [*required*]       | object   | Accounts whose users are affected by the issue.                                                                                                                                                                                                                             |
| accounts     | distinct_count [*required*] | int64    | Number of distinct accounts affected by the issue in the time window.                                                                                                                                                                                                       |
| accounts     | top [*required*]            | [object] | Up to five accounts with the most errors, most affected first.                                                                                                                                                                                                              |
| top          | error_counts [*required*]   | object   | Number of errors reported by each source. Several sources can report the same error, such as an APM span and a log, so the counts overlap: don't add them together.                                                                                                         |
| error_counts | apm [*required*]            | int64    | Number of errors reported by APM.                                                                                                                                                                                                                                           |
| error_counts | llmobs [*required*]         | int64    | Number of errors reported by Agent Observability.                                                                                                                                                                                                                           |
| error_counts | logs [*required*]           | int64    | Number of errors reported by Log Management.                                                                                                                                                                                                                                |
| error_counts | rum [*required*]            | int64    | Number of errors reported by RUM.                                                                                                                                                                                                                                           |
| top          | id [*required*]             | string   | Account ID, from the `account.id` attribute.                                                                                                                                                                                                                                |
| top          | name                        | string   | Account name, if available.                                                                                                                                                                                                                                                 |
| top          | significant [*required*]    | boolean  | Whether the entry stands out as a likely driver of the issue, because it accounts for most of the issue's errors or for far more errors than the other listed entries.                                                                                                      |
| attributes   | endpoints [*required*]      | object   | Endpoints whose traces have the issue's errors, identified by each trace's root span.                                                                                                                                                                                       |
| endpoints    | distinct_count [*required*] | int64    | Number of distinct endpoints affected by the issue in the time window.                                                                                                                                                                                                      |
| endpoints    | top [*required*]            | [object] | Up to five endpoints with the most errors, most affected first.                                                                                                                                                                                                             |
| top          | error_counts [*required*]   | object   | Number of errors reported by each source. Several sources can report the same error, such as an APM span and a log, so the counts overlap: don't add them together.                                                                                                         |
| error_counts | apm [*required*]            | int64    | Number of errors reported by APM.                                                                                                                                                                                                                                           |
| error_counts | llmobs [*required*]         | int64    | Number of errors reported by Agent Observability.                                                                                                                                                                                                                           |
| error_counts | logs [*required*]           | int64    | Number of errors reported by Log Management.                                                                                                                                                                                                                                |
| error_counts | rum [*required*]            | int64    | Number of errors reported by RUM.                                                                                                                                                                                                                                           |
| top          | resource_name [*required*]  | string   | Resource name of the trace's root span.                                                                                                                                                                                                                                     |
| top          | service [*required*]        | string   | Service of the trace's root span.                                                                                                                                                                                                                                           |
| top          | significant [*required*]    | boolean  | Whether the entry stands out as a likely driver of the issue, because it accounts for most of the issue's errors or for far more errors than the other listed entries.                                                                                                      |
| attributes   | error_counts [*required*]   | object   | Number of errors reported by each source. Several sources can report the same error, such as an APM span and a log, so the counts overlap: don't add them together.                                                                                                         |
| error_counts | apm [*required*]            | int64    | Number of errors reported by APM.                                                                                                                                                                                                                                           |
| error_counts | llmobs [*required*]         | int64    | Number of errors reported by Agent Observability.                                                                                                                                                                                                                           |
| error_counts | logs [*required*]           | int64    | Number of errors reported by Log Management.                                                                                                                                                                                                                                |
| error_counts | rum [*required*]            | int64    | Number of errors reported by RUM.                                                                                                                                                                                                                                           |
| attributes   | sessions [*required*]       | object   | RUM sessions where the issue occurred.                                                                                                                                                                                                                                      |
| sessions     | distinct_count [*required*] | int64    | Number of distinct sessions where the issue occurred in the time window.                                                                                                                                                                                                    |
| sessions     | top [*required*]            | [object] | Up to five sessions with the most errors, most affected first.                                                                                                                                                                                                              |
| top          | error_counts [*required*]   | object   | Number of errors reported by each source. Several sources can report the same error, such as an APM span and a log, so the counts overlap: don't add them together.                                                                                                         |
| error_counts | apm [*required*]            | int64    | Number of errors reported by APM.                                                                                                                                                                                                                                           |
| error_counts | llmobs [*required*]         | int64    | Number of errors reported by Agent Observability.                                                                                                                                                                                                                           |
| error_counts | logs [*required*]           | int64    | Number of errors reported by Log Management.                                                                                                                                                                                                                                |
| error_counts | rum [*required*]            | int64    | Number of errors reported by RUM.                                                                                                                                                                                                                                           |
| top          | id [*required*]             | string   | Session identifier.                                                                                                                                                                                                                                                         |
| top          | significant [*required*]    | boolean  | Whether the entry stands out as a likely driver of the issue, because it accounts for most of the issue's errors or for far more errors than the other listed entries.                                                                                                      |
| attributes   | users [*required*]          | object   | Users affected by the issue.                                                                                                                                                                                                                                                |
| users        | distinct_count [*required*] | int64    | Number of distinct users affected by the issue in the time window.                                                                                                                                                                                                          |
| users        | top [*required*]            | [object] | Up to five users with the most errors, most affected first.                                                                                                                                                                                                                 |
| top          | error_counts [*required*]   | object   | Number of errors reported by each source. Several sources can report the same error, such as an APM span and a log, so the counts overlap: don't add them together.                                                                                                         |
| error_counts | apm [*required*]            | int64    | Number of errors reported by APM.                                                                                                                                                                                                                                           |
| error_counts | llmobs [*required*]         | int64    | Number of errors reported by Agent Observability.                                                                                                                                                                                                                           |
| error_counts | logs [*required*]           | int64    | Number of errors reported by Log Management.                                                                                                                                                                                                                                |
| error_counts | rum [*required*]            | int64    | Number of errors reported by RUM.                                                                                                                                                                                                                                           |
| top          | id [*required*]             | string   | User ID, from the `usr.id` attribute.                                                                                                                                                                                                                                       |
| top          | name                        | string   | User name or email, if available.                                                                                                                                                                                                                                           |
| top          | significant [*required*]    | boolean  | Whether the entry stands out as a likely driver of the issue, because it accounts for most of the issue's errors or for far more errors than the other listed entries.                                                                                                      |
| attributes   | views [*required*]          | object   | RUM views where the issue occurred.                                                                                                                                                                                                                                         |
| views        | distinct_count [*required*] | int64    | Number of distinct view names where the issue occurred in the time window.                                                                                                                                                                                                  |
| views        | top [*required*]            | [object] | Up to five views with the most errors, most affected first.                                                                                                                                                                                                                 |
| top          | affected [*required*]       | object   | Distinct users, accounts, sessions, and view instances on a view. `affected` counts only those with the issue's errors. `baseline` counts all users, accounts, sessions, and view instances on the view in the time window. It is absent when RUM has no data for the view. |
| affected     | accounts [*required*]       | int64    | Number of distinct accounts.                                                                                                                                                                                                                                                |
| affected     | sessions [*required*]       | int64    | Number of distinct sessions.                                                                                                                                                                                                                                                |
| affected     | users [*required*]          | int64    | Number of distinct users.                                                                                                                                                                                                                                                   |
| affected     | views [*required*]          | int64    | Number of distinct view instances.                                                                                                                                                                                                                                          |
| top          | baseline                    | object   | Distinct users, accounts, sessions, and view instances on a view. `affected` counts only those with the issue's errors. `baseline` counts all users, accounts, sessions, and view instances on the view in the time window. It is absent when RUM has no data for the view. |
| baseline     | accounts [*required*]       | int64    | Number of distinct accounts.                                                                                                                                                                                                                                                |
| baseline     | sessions [*required*]       | int64    | Number of distinct sessions.                                                                                                                                                                                                                                                |
| baseline     | users [*required*]          | int64    | Number of distinct users.                                                                                                                                                                                                                                                   |
| baseline     | views [*required*]          | int64    | Number of distinct view instances.                                                                                                                                                                                                                                          |
| top          | error_counts [*required*]   | object   | Number of errors reported by each source. Several sources can report the same error, such as an APM span and a log, so the counts overlap: don't add them together.                                                                                                         |
| error_counts | apm [*required*]            | int64    | Number of errors reported by APM.                                                                                                                                                                                                                                           |
| error_counts | llmobs [*required*]         | int64    | Number of errors reported by Agent Observability.                                                                                                                                                                                                                           |
| error_counts | logs [*required*]           | int64    | Number of errors reported by Log Management.                                                                                                                                                                                                                                |
| error_counts | rum [*required*]            | int64    | Number of errors reported by RUM.                                                                                                                                                                                                                                           |
| top          | name [*required*]           | string   | View name.                                                                                                                                                                                                                                                                  |
| top          | significant [*required*]    | boolean  | Whether the entry stands out as a likely driver of the issue, because it accounts for most of the issue's errors or for far more errors than the other listed entries.                                                                                                      |
| data         | id [*required*]             | string   | Identifier of the issue.                                                                                                                                                                                                                                                    |
| data         | type [*required*]           | enum     | Type of the object. Allowed enum values: `error_tracking_issue_impact`.                                                                                                                                                                                                     |
{% /tab %}

{% tab label="Example" %}
```json
{
  "data": {
    "attributes": {
      "accounts": {
        "distinct_count": 18,
        "top": [
          {
            "error_counts": {
              "apm": 700,
              "llmobs": 0,
              "logs": 700,
              "rum": 440
            },
            "id": "acc-7",
            "name": "Acme",
            "significant": true
          }
        ]
      },
      "endpoints": {
        "distinct_count": 2,
        "top": [
          {
            "error_counts": {
              "apm": 700,
              "llmobs": 0,
              "logs": 700,
              "rum": 440
            },
            "resource_name": "POST /orders",
            "service": "checkout-api",
            "significant": true
          }
        ]
      },
      "error_counts": {
        "apm": 700,
        "llmobs": 0,
        "logs": 700,
        "rum": 440
      },
      "sessions": {
        "distinct_count": 540,
        "top": [
          {
            "error_counts": {
              "apm": 700,
              "llmobs": 0,
              "logs": 700,
              "rum": 440
            },
            "id": "8f1c3a52-6b1e-4a5e-9d0e-2c3b4a5d6e7f",
            "significant": false
          }
        ]
      },
      "users": {
        "distinct_count": 312,
        "top": [
          {
            "error_counts": {
              "apm": 700,
              "llmobs": 0,
              "logs": 700,
              "rum": 440
            },
            "id": "u-42",
            "name": "jane@example.com",
            "significant": true
          }
        ]
      },
      "views": {
        "distinct_count": 4,
        "top": [
          {
            "affected": {
              "accounts": 12,
              "sessions": 210,
              "users": 150,
              "views": 480
            },
            "baseline": {
              "accounts": 12,
              "sessions": 210,
              "users": 150,
              "views": 480
            },
            "error_counts": {
              "apm": 700,
              "llmobs": 0,
              "logs": 700,
              "rum": 440
            },
            "name": "/checkout",
            "significant": true
          }
        ]
      }
    },
    "id": "c1726a66-1f64-11ee-b338-da7ad0900002",
    "type": "error_tracking_issue_impact"
  }
}
```
{% /tab %}
{% /tabs %}
{% /tab %}

{% tab label="400" %}
Bad Request

{% tabs %}
{% tab label="Model" %}
API error response.

| Field               | Type     | Description       |
| ------------------- | -------- | ----------------- |
| errors [*required*] | [string] | A list of errors. |
{% /tab %}

{% tab label="Example" %}
```json
{
  "errors": [
    "Bad Request"
  ]
}
```
{% /tab %}
{% /tabs %}
{% /tab %}

{% tab label="401" %}
Unauthorized

{% tabs %}
{% tab label="Model" %}
API error response.

| Field               | Type     | Description       |
| ------------------- | -------- | ----------------- |
| errors [*required*] | [string] | A list of errors. |
{% /tab %}

{% tab label="Example" %}
```json
{
  "errors": [
    "Bad Request"
  ]
}
```
{% /tab %}
{% /tabs %}
{% /tab %}

{% tab label="403" %}
Forbidden

{% tabs %}
{% tab label="Model" %}
API error response.

| Field               | Type     | Description       |
| ------------------- | -------- | ----------------- |
| errors [*required*] | [string] | A list of errors. |
{% /tab %}

{% tab label="Example" %}
```json
{
  "errors": [
    "Bad Request"
  ]
}
```
{% /tab %}
{% /tabs %}
{% /tab %}

{% tab label="404" %}
Not Found

{% tabs %}
{% tab label="Model" %}
API error response.

| Field               | Type     | Description       |
| ------------------- | -------- | ----------------- |
| errors [*required*] | [string] | A list of errors. |
{% /tab %}

{% tab label="Example" %}
```json
{
  "errors": [
    "Bad Request"
  ]
}
```
{% /tab %}
{% /tabs %}
{% /tab %}

{% tab label="429" %}
Too many requests

{% tabs %}
{% tab label="Model" %}
API error response.

| Field               | Type     | Description       |
| ------------------- | -------- | ----------------- |
| errors [*required*] | [string] | A list of errors. |
{% /tab %}

{% tab label="Example" %}
```json
{
  "errors": [
    "Bad Request"
  ]
}
```
{% /tab %}
{% /tabs %}
{% /tab %}
{% /tabs %}

### Code Example

{% tabs %}
{% tab label="Curl" %}
```bash
# Path parameters
export issue_id="c1726a66-1f64-11ee-b338-da7ad0900002"
# Required query arguments
export filter_from="1794152269473"
export filter_to="1794238669473"

# Set your Datadog site and credentials
export DD_SITE="datadoghq.com" # Or us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu, ap1.datadoghq.com, ap2.datadoghq.com, uk1.datadoghq.com, ddog-gov.com, us2.ddog-gov.com
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X GET "https://api.${DD_SITE}/api/v2/error-tracking/issues/${issue_id}/impact?filter%5Bfrom%5D=${filter_from}&filter%5Bto%5D=${filter_to}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
```
{% /tab %}
{% /tabs %}
