v1

latestOpenAPI 3.1.02026-07-245531,0212.1 MB

Microsoft 365 Reports

View SharePoint Site Discovery Report

This report details backup and storage consumption for both enabled and disabled SharePoint sites. This API may be updated without any prior notification. Check the API documentation for the latest updates regularly.

post/msp/reporting/v1/reports/mspM365SharePointSiteDiscovery

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",
      "lastUpdatedTime": "2023-06-04T10:05:18.493Z",
      "siteName": "007 - pvt-channel-new",
      "siteURL": "https://dglobal.sharepoint.com/sites/007-pvt-channel-new",
      "siteType": "MS Teams Private Channel Site",
      "addedOn": "2024-08-08T14:05:50.000Z",
      "backupFrequency": 1440,
      "retention": "8D, 5W, 13M",
      "appStatus": "Enabled",
      "geolocation": "FRA (France)",
      "totalBackupData": 482739,
      "lastSuccessfulBackup": "2024-08-28T07:29:43.000Z",
      "lastBackupAttempted": "2024-08-28T07:29:43.000Z",
      "lastBackupStatus": "Backed Up Successfully",
      "errorDetailsOld": "-",
      "errorDetailsNew": "100000001",
      "storageRegion": "us-east-1"
    }
  ],
  "nextPageToken": "YTBDNDk6Rjk1MmViY1FpTVpBejNFTU9lSWxzUT09OjA="
}