---
title: User Activities
description: The User Activities service returns counts for successful and failed sign-on actions as well as a count for password resets over a designated period of time. The service uses stream processors that listen to users and login_attempts events. These events are collected and presented by time period. The service supports the SCIM startDate, endDate, and sampleSize query filtering parameters to request user-activity information for a specific date range and sample size.
component: pingone-api
page_id: pingone-api:platform:user-activities
canonical_url: https://developer.pingidentity.com/pingone-api/platform/user-activities.html
section_ids:
  assigning-admin-roles-and-permissions-to-this-service: Assigning admin roles and permissions to this service
  user-activities-data-model: User activities data model
  response-codes: Response codes
---

# User Activities

The User Activities service returns counts for successful and failed sign-on actions as well as a count for password resets over a designated period of time. The service uses stream processors that listen to `users` and `login_attempts` events. These events are collected and presented by time period. The service supports the SCIM `startDate`, `endDate`, and `sampleSize` query filtering parameters to request user-activity information for a specific date range and sample size.

## 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.html#automatic-role-assignment).

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

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

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

## User activities data model

| Property                | Type    | Required? | Mutable?  | Description                                                           |
| ----------------------- | ------- | --------- | --------- | --------------------------------------------------------------------- |
| `startDate`             | Date    | N/A       | Read-only | The start date for the activity period.                               |
| `endDate`               | Date    | N/A       | Read-only | The end date for the activity period.                                 |
| `environment.id`        | String  | N/A       | Read-only | The environment resource's unique identifier.                         |
| `userSignOns.successes` | Integer | N/A       | Read-only | The total number of successful user sign ons for the activity period. |
| `userSignOns.failures`  | Integer | N/A       | Read-only | The total number of failed user sign ons for the activity period.     |
| `passwordResets`        | Integer | N/A       | Read-only | The total number of password resets for the activity period.          |

## Response codes

| Code | Message                                  |
| ---- | ---------------------------------------- |
| 200  | Successful operation.                    |
| 201  | Successfully created.                    |
| 204  | Successfully removed. No content.        |
| 400  | The request could not be completed.      |
| 401  | You do not have access to this resource. |
| 404  | The requested resource was not found.    |

|   |                                                                                                   |
| - | ------------------------------------------------------------------------------------------------- |
|   | You need the Environment Admin or the Identity Data Admin role to read user activities resources. |