Sign in

v1

latestOpenAPI 3.1.02026-07-245531,0212.1 MB
Reports

Get Global Usage Report v2.0

Returns a detailed report on consumption units usage across all customers and products.

post/msp/reporting/v3/reports/mspGlobalUsage

Headers

Authorizationstring required

Specify the Bearer access token

Request body

pageTokenstring

The token to access the next page of results. Use the token value received in the previous response's parameter 'nextPageToken'.

  • Keep this field blank in the first request.

Example request

{
  "pageToken": "eyJwYWdlTnVtYmVyIjoyLCJwYWdlU2l6ZSI6NTAwLCAiZmlsdGVycyI6bnVsbH0=",
  "filters": {
    "pageSize": 10,
    "filterBy": [
      {
        "fieldName": "accountName",
        "value": "Customer_51",
        "operator": "EQUAL"
      }
    ]
  }
}

Response

Ok

lastSyncTimestampstring date-time

Last time sync up timestamp date. Sync up time does not guarantee that consumption stats till this time are included in reported stats. Reported consumption stats may be stale upto 48 hours.

nextPageTokenstring

The token to access the next page of results. This parameter will be empty for the last page of results.

Example response

{
  "data": [
    {
      "accountName": "Customer_51",
      "cuConsumption": 279.48909,
      "customerName": "Customer_5",
      "dcpUniqueKey": "8ab1417529fa5a5c8d244db4554a163b05418b0bc8564abd47612332a9fd2d66",
      "edition": "enterprise",
      "mspGlobalId": "MSP:00864ec2-f925-4552-91bd-89101f9a32c6",
      "mspName": "Example MSP Organization",
      "productModule": "Google Workspace",
      "servicePlan": "ins_ent_plain",
      "tenantType": "Commercial"
    }
  ],
  "filters": {
    "pageSize": 5,
    "filterBy": [
      {
        "fieldName": "accountName",
        "value": "Customer_51",
        "operator": "EQUAL"
      }
    ]
  },
  "lastSyncTimestamp": "2025-10-20T04:53:06Z",
  "nextPageToken": "OTdjOGM1NTYtMWYyMC00ODBhLWIxNzUtODFmOWY5YzY0MGM3"
}