---
title: "Get aggregated metrics for all users"
method: POST
path: "/analytics/metrics/users/all"
tags: ["Analytics"]
---

# Get aggregated metrics for all users

`POST /analytics/metrics/users/all`

Provides aggregated metrics across all users within their account. This endpoint provides summary statistics about user activity and performance.

<!-- 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

- AnalyticsUserFilter
  - `filters` AnalyticsUserFilterConditions
    - `created_at_start` string, date-time — The start of the date range to search
    - `created_at_end` string, date-time — The end of the date range to search
    - `team_ids` string[] — An array of team IDs. Only users belonging to these teams will be included in results.
    - `user_ids` string[] — An array of user IDs. Only these users will be included in results.
    - `role_ids` string[] — An array of role IDs. Only users with these roles will be included in results.
  - `time_zone` string — The time zone to use for the results and grouping. Must be in tzdata format. See list of accepted values [here](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).
  - `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.
  - `aggregate_unit` 'day' | 'week' | 'month', nullable — The time unit to aggregate metrics by. If no value is provided, the metrics will be aggregated for the entire period.
  - `limit` integer — The maximum number of results to return per page. The default (and maximum allowed value) is 1000.
  - `starting_after` string, nullable — A cursor used for pagination. Starting after cursor provides the next set of results in forward pagination order.
  - `ending_before` string, nullable — A cursor used for pagination. Ending before cursor provides the previous set of results in reverse pagination order.

## Response `200`

Returns user metrics aggregated across the account

- object
  - `data` AnalyticsUserMetrics[]
    - `total_downloaded_mobile_app_count` integer — The number of users who have downloaded the mobile app.
    - `total_downloaded_mobile_app_percentage` number, float — The percentage of users who have downloaded the mobile app.
    - `total_on_escalation_policy_count` integer — The number of users who are on at least one escalation policy.
    - `total_on_escalation_policy_percentage` number, float — The percentage of users who are on at least one escalation policy.
    - `total_signed_up_count` integer — The number of users who have signed up (completed onboarding).
    - `total_signed_up_percentage` number, float — The percentage of users who have signed up.
    - `total_user_count` integer — The total number of users in the account that match the filters.
    - `total_with_notification_methods_count` integer — The number of users who have at least one notification method configured.
    - `total_with_notification_methods_percentage` number, float — The percentage of users who have at least one notification method configured.
  - `filters` object
    - `created_at_start` string, date-time — The start of the date range used for filtering
    - `created_at_end` string, date-time — The end of the date range used for filtering
    - `team_ids` string[] — The team IDs used for filtering
  - `time_zone` string — The time zone used for 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)