v1

latestOpenAPI 3.1.02026-07-245531,0212.1 MB

Google Workspace Reports

View License Usage Report

View the weekly and monthly count of total active and preserved licenses allocated and consumed. This API may be updated without any prior notification. Check the API documentation for the latest updates regularly.

post/msp/reporting/v1/reports/mspGoogleLicenseUsage

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-10-01T00:00:00.000Z",
      "endDate": "2024-10-31T23:59:59.000Z",
      "usersDeleted": 22,
      "totalActiveLicense": 100,
      "totalPreservedLicense": 20
    }
  ],
  "nextPageToken": "YTBDNDk6Rjk1MmViY1FpTVpBejNFTU9lSWxzUT09OjA="
}