Sign in

v1

latestOpenAPI 3.1.02026-07-245531,0212.1 MB
Microsoft 365 Reports

View Users Count & Status Report

View the weekly and monthly count of users added, preserved, and deleted for a specified period. This API may be updated without any prior notification. Check the API documentation for the latest updates regularly.

post/msp/reporting/v1/reports/mspM365UserCountAndStatus

Headers

Authorizationstring required

Specify the Bearer access token

Request body

pageTokenstring

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.

Example request

{
  "filters": {
    "filterBy": [
      {
        "fieldName": "accountName",
        "operator": "EQUAL"
      }
    ]
  }
}

Response

Success

lastSyncTimestampstring date-time

The time stamp until which the report data was returned. The time is in the UTC time zone.

filtersobject

Filters applied on the report.

nextPageTokenstring

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.

Example response

{
  "data": [
    {
      "accountName": "Druva",
      "customerName": "Druva",
      "customerGlobalId": "bde7f8c2-d063-4a4a-9a8f-c2ea5aff42f3-198",
      "period": "month",
      "startDate": "2024-03-01T00:00:00.000Z",
      "endDate": "2024-03-31T23:59:59.000Z",
      "totalUsers": 16,
      "userAdded": 17,
      "usersDeleted": 1
    }
  ],
  "nextPageToken": "YTBDNDk6Rjk1MmViY1FpTVpBejNFTU9lSWxzUT09OjA="
}