---
title: "Get responder data aggregated by team"
method: POST
path: "/analytics/metrics/responders/teams"
tags: ["Analytics"]
---

# Get responder data aggregated by team

`POST /analytics/metrics/responders/teams`

Provides incident metrics aggregated by responder.

Example metrics include Seconds to Resolve, Seconds to Engage, Snoozed Seconds, and Sleep Hour Interruptions. Metric definitions can be found in our [Knowledge Base](https://support.pagerduty.com/docs/insights#responders-list).

<!-- theme: info -->
> **Note:** Data availability reflects [pipeline processing cycles](https://support.pagerduty.com/main/docs/insights#:~:text=Data%20Update%20Schedule) and is generally within 24 hours under normal conditions.

Scoped OAuth requires: `analytics.write`

## Headers

- `Accept` string, required
- `Content-Type` 'application/json', required

## Request body

- AnalyticsResponderFilter
  - `filters` object — Accepts a set of filters to apply to the Incidents before aggregating. Any incidents that do not match the included filters will be omitted from the results
    - `date_range_start` string — Accepts an ISO8601 DateTime string. Any incidents with a created_at less than this value will be omitted from the results. The maximum supported time range in conjunction with date_range_end is one year.
    - `date_range_end` string — Accepts an ISO8601 DateTime string. Any incidents with a created_at greater than or equal to this value will be omitted from the results. The maximum supported time range in conjunction with date_range_start is one year.
    - `urgency` 'high' | 'low' — Any incidents whose urgency does not match the provided string will be omitted from the results.
    - `team_ids` string[] — An array of team IDs. Only incidents related to these teams will be included in the results. If omitted, all teams the requestor has access to will be included in the results.
    - `responder_ids` string[] — An array of responder IDs. Only incidents related to these responders will be included in the results. If omitted, all responders the requestor has access to will be included in the results.
    - `priority_ids` string[] — An array of priority IDs. Only incidents with these priorities will be included in the results. If omitted, all priorities will be included in the results.
    - `priority_names` string[] — An array of user-defined priority names. Only incidents with these priorities will be included in the results. If omitted, all priorities will be included in the results.
  - `time_zone` string — The time zone to use for the results and grouping.
  - `order` 'asc' | 'desc' — The order in which the results were sorted; asc for ascending, desc for descending.
  - `order_by` string — The column that was used for ordering the results.

## Response `200`

Only returns data for responders and teams that match the filters and have data.

- object
  - `data` AnalyticsResponderMetrics[]
    - `mean_engaged_seconds` integer — Mean engaged time across all responders for incidents that match the given filters. Engaged time is measured from the time a user engages with an incident (by acknowledging or accepting a responder request) until the incident is resolved. This may include periods in which the incidents were snoozed.
    - `mean_time_to_acknowledge_seconds` integer — The average time between when an incident is first assigned to a user and when the incident is first acknowledged by that user. Reassign, resolve, and escalation actions do not imply acknowledgement.
    - `responder_id` integer — ID of the responder (user). Not included when aggregating by all responders.
    - `responder_name` string — Name of the responder (user). Not included when aggregating by all responders.
    - `team_id` string — ID of the team associated with the responder. Not included when aggregating by all responders.
    - `team_name` string — Name of the team associated with the responder. Not included when aggregating by all responders.
    - `total_business_hour_interruptions` integer — Total number of unique interruptions during business hours; 8am-6pm Mon-Fri, based on the user’s time zone.
    - `total_engaged_seconds` integer — Total engaged time across all responders for incidents. Engaged time is measured from the time a user engages with an incident (by acknowledging or accepting a responder request) until the incident is resolved. This may include periods in which the incidents were snoozed.
    - `total_incident_count` integer — The total number of incidents that were created.
    - `total_incidents_acknowledged` integer — The total count of assigned incidents acknowledged by the user. Only explicit incident acknowledgment counts; reassign, resolve, and escalation actions do not imply acknowledgement.
    - `total_incidents_manual_escalated_from` integer — The total count of the user’s assigned incidents that were manually escalated away from a user without acknowledgement.
    - `total_incidents_manual_escalated_to` integer — The total count of incidents the user was manually escalated to.
    - `total_incidents_reassigned_from` integer — The total count of a user's assigned incidents that were reassigned away from the user to another user or escalation policy.
    - `total_incidents_reassigned_to` integer — The total count of incidents the user was reassigned to.
    - `total_incidents_timeout_escalated_from` integer — The total count of the user’s assigned incidents that were escalated due to timeouts.
    - `total_incidents_timeout_escalated_to` integer — The total count of incidents the user was escalated to due to timeouts.
    - `total_interruptions` integer — Total number of unique interruptions.
    - `total_notifications` integer — The total count of incident notifications sent via email, SMS, phone call and push.
    - `total_off_hour_interruptions` integer — Total number of unique interruptions during off hours; 6pm-10pm Mon-Fri and all day Sat-Sun, based on the user’s time zone.
    - `total_seconds_on_call` integer — Total seconds the responder was on call.
    - `total_seconds_on_call_level_1` integer — Total seconds the responder was on call at level 1 of their escalation policy.
    - `total_seconds_on_call_level_2_plus` integer — Total seconds the responder was on call at level 2 or higher of their escalation policy.
    - `total_sleep_hour_interruptions` integer — Total number of unique interruptions during sleep hours; 10pm-8am every day, based on the user’s time zone.
  - `filters` object — Accepts a set of filters to apply to the Incidents before aggregating. Any incidents that do not match the included filters will be omitted from the results
    - `date_range_start` string — Accepts an ISO8601 DateTime string. Any incidents with a created_at less than this value will be omitted from the results. The maximum supported time range in conjunction with date_range_end is one year.
    - `date_range_end` string — Accepts an ISO8601 DateTime string. Any incidents with a created_at greater than or equal to this value will be omitted from the results. The maximum supported time range in conjunction with date_range_start is one year.
    - `urgency` 'high' | 'low' — Any incidents whose urgency does not match the provided string will be omitted from the results.
    - `team_ids` string[] — An array of team IDs. Only incidents related to these teams will be included in the results. If omitted, all teams the requestor has access to will be included in the results.
    - `responder_ids` string[] — An array of responder IDs. Only incidents related to these responders will be included in the results. If omitted, all responders the requestor has access to will be included in the results.
    - `priority_ids` string[] — An array of priority IDs. Only incidents with these priorities will be included in the results. If omitted, all priorities will be included in the results.
    - `priority_names` string[] — An array of user-defined priority names. Only incidents with these priorities will be included in the results. If omitted, all priorities will be included in the results.
  - `time_zone` string — The time zone to use for the results and grouping.
  - `order` 'asc' | 'desc' — The order in which the results were sorted; asc for ascending, desc for descending.
  - `order_by` string — The column that was used for ordering the results.

## Other responses

- `400` — Caller provided invalid arguments. Please review the response for error details. Retrying with the same arguments will *not* work.
- `429` — Too many requests have been made, the rate limit has been reached.

---

[API](https://skmtc.net/pagerduty/apis/rest-api.md) · [All operations](https://skmtc.net/pagerduty/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pagerduty/rest-api/revisions/b679a8f3f02c/schema)