---
title: "View SharePoint Site Discovery Report"
method: POST
path: "/msp/reporting/v1/reports/mspM365SharePointSiteDiscovery"
tags: ["Microsoft 365 Reports"]
---

# View SharePoint Site Discovery Report

`POST /msp/reporting/v1/reports/mspM365SharePointSiteDiscovery`

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.

## 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.
      - `fieldName` 'accountName' | 'customerName' | 'customerGlobalId' | 'lastUpdatedTime' | 'siteName' | 'siteURL' | 'siteType' | 'addedOn' | 'backupFrequency' | 'retention' | 'appStatus' | 'geolocation' | 'totalBackupData' | 'lastSuccessfulBackup' | 'lastBackupAttempted' | 'lastBackupStatus' | 'errorDetailsOld' | 'errorDetailsNew' | 'storageRegion' | 'isDeleted' — 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

- GetM365SharePointSiteDiscoveryReportDataResponse
  - `data` M365SharePointSiteDiscoveryReportData[]
    - `accountName` string — Account name defined for the customer
    - `customerName` string — Customer name defined for the customer
    - `customerGlobalId` string — Unique ID of 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
    - `siteName` string — Specifies the name of the site stored in DB.
    - `siteURL` string — Specifies the URL for that site.
    - `siteType` string — Specifies the type of a particular site. For example - "MS Teams Site", "M365 Groups Site"
    - `addedOn` string, date-time — EPOCH timestamp indicates the time when the site was added to DB.
    - `backupFrequency` integer — Specifies the backup frequency denoted by specific integer values. For example: • 720 - Twice A day • 1440 - Once A day • 4320 - Twice A Week • 10080 - Once A Week • 480 - Thrice A day • 2880 - Thrice A Week • 240 - Five Times a day • 0 - Never
    - `retention` string — Specifies the retention policy for backups, indicating the duration for which backups will be kept. The format follows a combination of days (D), weeks (W), and months (M). For example, "5D, 4W, 12M" means backups will be retained for 5 days, 4 weeks, and 12 months.
    - `appStatus` string — Specifies the status of the configured site. For example - "Enabled" or "Disabled"
    - `geolocation` string — Specifies the geolocation of the configured site. For example - "APC (Macro Region Geography 2 - Asia-Pacific)", "AUS (Australia)"
    - `totalBackupData` integer — Specifies the value of the total backup data stored in bytes.
    - `lastSuccessfulBackup` string, date-time — Specifies the EPOCH timestamp indicating the time when the last backup was successful.
    - `lastBackupAttempted` string, date-time — Specifies the EPOCH timestamp indicating the time when the last backup was attempted.
    - `lastBackupStatus` string — Specifies the status of the last backup attempted, Example - "`Backup Successful`"
    - `errorDetailsOld` string — A string representing error occured for the last backup job. For example - "`EUSERNOTFOUND`"
    - `errorDetailsNew` string — A string represents all the errors during the last backup in a comma-separated format. For example - "100010016,100000001". The actual error strings associated with the error codes are as below. **100000001** - Internal error **1000000f7** - Throttling Issue **10000000b** - Quota limit reached **10000000A** - Task Aborted **100000016** - Authorization Failed **100000046** - Insufficient Permissions **10000004b** - Task Canceled **100010001** - File is checked out **100010002** - MS Team site channel update failed **100010007** - Character Limit Exceeded **100010009** - Token Invalid **10001000f** - User Not Found **100010010** - Microsoft List View Threshold Reached **100010011** - Virus Infected File **100010013** - File Not Found **100010014** - Connection Error From Microsoft **100010015** - The site level feature is not available in SharePoint Online **100010016** - Site Not Found **100010017** - Metadata Restore Failed **100010018** - Site Feature Restore Failed **100010019** - Quick Launch Node Restore Failed **10001001a** - Top Navigation Bar Restore Failed **10001001b** - Term Store Restore Failed **10001001c** - List Item Restore Failed **10001001d** - Site Not Found in SharePoint PowerShell **10001001f** - SharePoint Site Busy **100010020** - SharePoint Storage Issue **100010023** - Cannot Restore Active Solution **100010024** - SharePoint Site Locked
    - `storageRegion` string — Specifies the name of the storage assigned.
    - `isDeleted` integer — Indicates whether the site is deleted from the database.
  - `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)
