---
title: "Get Itemized Tenant Quota Report v2.0"
method: POST
path: "/msp/reporting/v3/reports/quotaItemized"
tags: ["Reports"]
---

# Get Itemized Tenant Quota Report v2.0

`POST /msp/reporting/v3/reports/quotaItemized`

Returns a detailed daily report on MSP tenant quota usage based on the currently active quota. 
 If no active quota exists, the report uses the last active quota. 
 Quotas set to 0 are excluded.

## Headers

- `Authorization` string, required

## Request body

- GetTenantItemizedReportV3Request — Specify the details for getting itemized report details.
  - `pageToken` string — 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.
  - `filters` FilterTypeV3
    - `pageSize` integer — Specify the maximum number of records that should returned in a response. The default page size is 100 records. The maximum limit is 500 records. :fa-info-circle: If you specify the pageSize, value from the first API call will be used for the subsequent calls, even if you change the pageSize later on.
    - `filterBy` FilterAttributeV3[] — Filters if needs to be applied.
      - `fieldName` 'customerGlobalId' | 'accountName' | 'tenantId' | 'productId' | 'productModuleId' | 'date' | 'editionName' | 'servicePlanId' | 'usageDescription' | 'mspGlobalId' | 'mspName' — Specify the name of the filter attribute.
      - `value` string — Specify value of column that needs to be filtered. For CONTAINS operator - this can be array of either int or string. For other operators, depending on the datatype of fieldName attribute this can be either int / string / RFC3339 date format. This is case sensitive.
      - `operator` 'EQUAL' | 'NOTEQUAL' | 'CONTAINS' | 'LT' | 'GT' | 'LTE' | 'GTE' — Operator for specified filters. All string comparisons will be case sensitive. Supported filters are: - EQUAL: This will return the data with exact match for given field name. - NOTEQUAL: This will return the data not matching with given values. - CONTAINS: Value for this operator will be an array. This will return data which matches with any value mentioned in array. - LT: This is the 'LESS THAN' comparison operator. - LTE: This is the 'LESS THAN OR EQUAL TO' comparison operator. - GT: This is the 'GREATER THAN' comparison operator. - GTE: This is the 'GREATER THAN OR EQUAL TO' comparison operator. For a particular field name an operator can be used once at max. For columns having string data type 'LT', 'LTE', 'GT', 'GTE' operators will work lexicographically.

## Response `200`

Ok

- GetTenantQuotaItemizedReportV3Response
  - `data` TenantDataItemizedV3[] — The list contains itemized details about quota usage. Includes mspGlobalId and mspName for parent-child hierarchy visibility.
    - `customerGlobalId` string — Unique ID of the customer.
    - `mspGlobalId` string — Global ID of the MSP that owns the consumption data.
    - `mspName` string — Organization name of the MSP that owns the consumption data.
    - `accountName` string — The name of the customer.
    - `tenantId` string — Unique id of the tenant. This is the 'id' field defined in GET Tenant API.
    - `productId` 1 | 2 — The ID of the product. 1 - Enterprise Workloads, 2 - SaaS Apps and Endpoints.
    - `productName` 'Enterprise Workloads' | 'SaaS Apps and Endpoints' — The name of the product.
    - `productModuleId` 1 | 2 | 3 | 4 — The ID of the product module. 1 - Enterprise Workloads, 2 - Microsoft 365, 3 - Endpoints, 4 - Google Workspace
    - `productModuleName` 'Enterprise Workloads' | 'Microsoft 365' | 'Endpoints' | 'Google Workspace' — The name of the product module.
    - `editionName` 'Business' | 'Enterprise' | 'Elite' — The name of the edition.
    - `tenantType` 'Commercial' | 'Evaluation' — Type of the tenant.
    - `date` string, date — Date indicates the date of usage. Date is specified in 'RFC3339' format.
    - `servicePlanId` integer — The unique ID of the MSP service plan assigned to the tenant.
    - `servicePlanName` string — The name of the MSP service plan assigned to the tenant.
    - `usageDescription` string — Usage description indicates the type of consumption e.g. 'Active Users', 'Sensitive Data Governance', 'Accelerated Ransomware Recovery' etc.
    - `usageAmount` number, double — Usage amount indicates usage for the usage type mentioned in 'usageDescription' field.
    - `usageUnit` 'Users' | 'Bytes' — Usage unit defines unit of usage. It will be 'Bytes' for productId 1 and 'Users' for productId 2.
    - `cuConsumed` number, double — The amount of consumption units consumed by tenant on given day.
    - `dcpUniqueKey` string — The unique key identifier of the record.
  - `nextPageToken` string — The token to access the next page of results. This parameter will be empty for the last page of results.
  - `filters` object — All filters passed in request are returned in response
    - `pageSize` integer — Maximum number of records that can be returned in the response.
    - `filterBy` FilterAttributeV3[] — Filters applied in the request.
      - `fieldName` 'customerGlobalId' | 'accountName' | 'tenantId' | 'productId' | 'productModuleId' | 'date' | 'editionName' | 'servicePlanId' | 'usageDescription' | 'mspGlobalId' | 'mspName' — Specify the name of the filter attribute.
      - `value` string — Specify value of column that needs to be filtered. For CONTAINS operator - this can be array of either int or string. For other operators, depending on the datatype of fieldName attribute this can be either int / string / RFC3339 date format. This is case sensitive.
      - `operator` 'EQUAL' | 'NOTEQUAL' | 'CONTAINS' | 'LT' | 'GT' | 'LTE' | 'GTE' — Operator for specified filters. All string comparisons will be case sensitive. Supported filters are: - EQUAL: This will return the data with exact match for given field name. - NOTEQUAL: This will return the data not matching with given values. - CONTAINS: Value for this operator will be an array. This will return data which matches with any value mentioned in array. - LT: This is the 'LESS THAN' comparison operator. - LTE: This is the 'LESS THAN OR EQUAL TO' comparison operator. - GT: This is the 'GREATER THAN' comparison operator. - GTE: This is the 'GREATER THAN OR EQUAL TO' comparison operator. For a particular field name an operator can be used once at max. For columns having string data type 'LT', 'LTE', 'GT', 'GTE' operators will work lexicographically.
  - `lastSyncTimestamp` string, 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.

## Other responses

- `400` — Bad Request
- `401` — The request did not include an authentication token or an expired authentication token was supplied.
- `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)