---
title: "View User Rollout Report"
method: POST
path: "/msp/reporting/v1/reports/mspEPUserRollout"
tags: ["Endpoints Reports"]
---

# View User Rollout Report

`POST /msp/reporting/v1/reports/mspEPUserRollout`

This report provides user devices, their activation date, and the status of first backup of MSP customers. This API may be updated without any prior notification. Check the API documentation for the latest updates regularly.

## Headers

- `Authorization` string, required

## Request body

- object
  - `filters` object
    - `pageSize` integer — Specify the maximum number of records that should returned in a response. Maximum limit is 500 records. Default pageSize is 100.
    - `filterBy` object[] — Select the filters to be applied to the report. If you do not specify a date filter, the lastUpdatedTime filter is set to 1 day by default.
      - `fieldName` 'customerGlobalId' | 'accountName' | 'customerName' | 'lastUpdatedTime' | 'userName' | 'userEmail' | 'customAttributeValue' | 'customAttributeName' | 'addedOn' | 'profileName' | 'licenseData' | 'source' | 'activatedOn' | 'systemSettings' | 'lastBackupStatus' | 'lastBackupTime' | 'firstBackupStatus' | 'isDeleted' | 'firstBackupSizeMB' | 'bytesTransferredMB' | 'timeTakenHhMm' | 'clientVersion' | 'osPlatform' | 'lastUpgradedOn' | 'upgradeState' | 'deviceOS' — Specify the name of the filter.
      - `operator` 'EQUAL' | 'GT' | 'GTE' | 'LT' | 'LTE' | 'CONTAINS' | 'NOTEQUAL' — The operators that are supported for the filter are - EQUAL, NOTEQUAL, CONTAINS, LT (less-than), LTEQ (less-than-or-equal), GT (greater-than), GTEQ (greater-than-or-equal).
      - `value` union — Specify the value of the filter applied to the report.
        - string — string
        - integer — integer
        - string[] — array of strings
        - integer[] — array of integers
  - `pageToken` string — Specify the token to access the results on the next page. Keep this field blank for the first request. To view the results on the next page, use the value received in the 'nextPageToken' parameter of the previous response.

## Response `200`

Success

- GetUserRolloutReportDataResponse
  - `data` UserRolloutReportData[]
    - `customerGlobalId` string — Unique ID of the customer.
    - `accountName` string — Account name defined for the customer
    - `customerName` string — Customer name defined for the customer
    - `lastUpdatedTime` string, date-time — The last updated time stamp for the record. The time is in the UTC time zone. Example - 2019-10-25T00:00:00Z
    - `userName` string — Displays the user name to whom the device belongs.
    - `userEmail` string — Displays the email ID of the user to whom the device belongs.
    - `customAttributeValue` string — The value of the attribute in the AD server.
    - `customAttributeName` string — Name of the attribute in the AD server.
    - `addedOn` string, date-time — The date and time when the user was added. The time is in the UTC time zone.
    - `profileName` string — Displays the name of the profile with which the user is associated.
    - `licenseData` string — The status of the license of the workload, the data source belongs to. For example, active, preserve or "-", where "-" indicates unlicensed state.
    - `source` string — The name of the device which the user is associated with.
    - `activatedOn` string — The date and time when the device was activated.
    - `systemSettings` string — The status of whether the device's system settings were backed up.
    - `lastBackupStatus` string — The status of the last backup operation.
    - `isDeleted` integer — Indicates the current status of the user account. 1- The user account is deleted. 0- The user account is active.
    - `lastBackupTime` string — The time taken(Unix format) for the last backup operation to complete in hours and minutes.
    - `firstBackupStatus` string — The status of the first backup operation.
    - `firstBackupSizeMB` string — The size of the files in MB that were backed up during the last backup operation.
    - `bytesTransferredMB` string — The number of bytes transferred during backup.
    - `timeTakenHhMm` string — The time taken for the backup operation to complete in hours and minutes.
    - `clientVersion` string — The version of inSync Client on the user device.
    - `osPlatform` string — The operating system platform on the user device.
    - `lastUpgradedOn` string — The date and time when the inSync Client on the user device was last upgraded. Example - 2019-10-25T00:00:00Z.
    - `upgradeState` string — The upgrade state of inSync Client on the user device. This field shows one of the following values- UPGRADEABLE, NOT UPGRADABLE, UPTODATE
    - `deviceOS` string — The operating system platform on the user device.
  - `lastSyncTimestamp` string, date-time — The time stamp until which the report data was returned. The time is in the UTC time zone.
  - `filters` object — Filters applied on the report.
  - `nextPageToken` string — The token to access the next page of results. This parameter will be empty for the last page of the results. This token is valid for 5 minutes.

## Other responses

- `400` — Bad Request
- `404` — The requested resource was not found.
- `500` — The request was not processed due to an internal error.

---

[API](https://skmtc.net/druva/apis/authentication.md) · [All operations](https://skmtc.net/druva/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/druva/authentication/versions/2af2bf148b25/schema)