Sign in

v1

latestOpenAPI 3.1.02026-07-245531,0212.1 MB
Reports

Get Itemized Tenant Quota Report v2.0

⚠ Warning: This API version will be deprecated on August 28, 2026. Upgrade to v3 API now to experience enhanced functionality and performance. Returns a detailed, daily, report on the quota usage by MSP tenants. It displays consumption based on the currently active quota. If there is no active quota defined, the report will show consumption from the last active quota. If the quota that needs to be reported is set to 0, it will be excluded from the report.

post/msp/reporting/v2/reports/quotaItemized

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": "customerGlobalId",
        "value": "b825cee3-5780-45ca-bc1d-83a9ccec5d7b",
        "operator": "EQUAL"
      }
    ]
  }
}

Response

Ok

nextPageTokenstring

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

lastSyncTimestampstring date

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.

Example response

{
  "data": [
    {
      "customerGlobalId": "bde7f8c2-d063-4a4a-9a8f-c2ea5aff42f3-198",
      "accountName": "Example customer",
      "mspGlobalId": "MSP:00864ec2-f925-4552-91bd-89101f9a32c6",
      "tenantId": "0001f138-0c37-4980-b3f2-a3342f201ba4",
      "productId": 2,
      "productName": "SaaS Apps and Endpoints",
      "productModuleId": 3,
      "productModuleName": "Endpoints",
      "editionName": "Elite",
      "tenantType": "Commercial",
      "date": "2023-01-11T00:00:00.000Z",
      "servicePlanId": 2,
      "servicePlanName": "Example service plan",
      "usageDescription": "Sensitive Data Governance",
      "usageAmount": 1,
      "usageUnit": "Users",
      "cuConsumed": 1.5
    },
    {
      "customerGlobalId": "bde7f8c2-d063-4a4a-9a8f-c2ea5aff42f3-198",
      "accountName": "Example customer",
      "mspGlobalId": "MSP:00864ec2-f925-4552-91bd-89101f9a32c6",
      "tenantId": "0001f138-0c37-4980-b3f2-a3342f201ba3",
      "productId": 1,
      "productName": "Enterprise Workloads",
      "productModuleId": 1,
      "productModule": "Enterprise Workloads",
      "editionName": "Elite",
      "tenantType": "Commercial",
      "date": "2023-01-11T00:00:00.000Z",
      "servicePlanName": "Example service plan",
      "usageDescription": "Accelerated Ransomware Recovery",
      "usageAmount": 178,
      "usageUnit": "Bytes",
      "cuConsumed": 94
    }
  ],
  "nextPageToken": "eyJwYWdlTnVtYmVyIjoyLCJwYWdlU2l6ZSI6NTAwLCAiZmlsdGVycyI6bnVsbH0=",
  "filters": {
    "pageSize": 10,
    "filterBy": [
      {
        "fieldName": "customerGlobalId",
        "value": "b825cee3-5780-45ca-bc1d-83a9ccec5d7b",
        "operator": "EQUAL"
      }
    ]
  },
  "lastSyncTimestamp": "2023-01-11T00:00:00.000Z"
}