---
title: Total Identities
description: Track the total count of unique identities in a PingOne environment over daily reporting periods for a specified date range
component: pingone-api
page_id: pingone-api:platform:total-identities/index
canonical_url: https://developer.pingidentity.com/pingone-api/platform/total-identities/index.html
llms_txt: https://developer.pingidentity.com/pingone-api/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
revdate: 2026-08-11
section_ids:
  assigning-admin-roles-and-permissions-to-this-service: Assigning admin roles and permissions to this service
  total-identities-data-model: Total identities data model
  response-codes: Response codes
---

# Total Identities

The total identities service retrieves the count of unique identities associated with a specified environment. The response shows the total number of users, divided into daily (24-hour) reporting periods, from the specified `startDate` through the `endDate`. The total identities count tracks the add and delete user operations to determine the changes in total number of unique identities over each 24-hour period. This service uses a SCIM query filter to control the sample size, showing the unique identity counts (on a per day basis) within the specified date range.

## Assigning admin roles and permissions to this service

Admin role assignments determine access to PingOne APIs. When assigning admin roles to this service, refer to [PingOne Permissions by Service](../reference/roles-and-permissions-in-pingone/permissions-by-service.html) for the service-specific permissions.

You can also choose to assign admin roles based on particular service resources. Refer to [PingOne Permissions by Resource](../reference/roles-and-permissions-in-pingone/permissions-by-resource.html) when assigning admin roles per service resources.

Admin assignments to roles are set by:

* [Automatic assignment for some roles](../roles/predefined-roles/index.html#automatic-role-assignment).

* [Group Role Assignments](../group-role-assignments/group-role-assignments.html).

* [User Role Assignments](../users/user-role-assignments/index.html).

Refer to [Roles Management](../roles/index.html) for more information.

## Total identities data model

| Property          | Type    | Required | Mutable   | Description                                                                                    |
| ----------------- | ------- | -------- | --------- | ---------------------------------------------------------------------------------------------- |
| `date`            | Date    | N/A      | Read-only | The date and time the total identities count starts for the sampling period (ISO 8601 format). |
| `totalIdentities` | Integer | N/A      | Read-only | The total unique identities count for the sampling period.                                     |

|   |                                                                                                                                                                                                                                 |
| - | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|   | The `count` attribute in the response data shows the current number of unique identities for the environment. For more information, see For more information, refer to [Conventions](../../foundations/conventions/index.html). |

## Response codes

| Code | Message                                                               |
| ---- | --------------------------------------------------------------------- |
| 200  | Successful operation.                                                 |
| 400  | The request could not be completed.                                   |
| 401  | You do not have access to this resource.                              |
| 403  | You do not have permissions or are not licensed to make this request. |
| 404  | The requested resource was not found.                                 |
| 500  | Internal server error.                                                |