Skip to main content

getMonthlyUsagePerProductType

The method exposes the monthly usage of a company in a target month. Returns the usage per product type, for all available product types.

Parameters

Parameter

Type

Optional

Description

companyId

String

Yes

The ID of the company. The default value is the ID of the company linked to the user who generated the API key.

targetMonth

String

Yes

The month for which the usage is returned. It should have the following format: mm/yyyy. The default value is the current month.

Return value

This method returns an Object containing the following:

  • usages - An array of Objects that contain the number of license seats used during the specified month, for each acquired service and product type.

    For Endpoint Security, the object contains the following members:

    • productType, the product type.

    • endpointMonthlyUsage, the monthly usage for endpoints scanned with local engines.

    • aLaCarteMonhtlyUsage - the monthly usage for endpoints scanned with local engines that belong to companies that use the A-la-carte protection model.

    • mspSecureMonthlyUsage - the monthly usage for endpoints scanned with local engines that belong to companies that use the Secure protection model.

    • mspSecurePlusMonthlyUsage - the monthly usage for endpoints scanned with local engines that belong to companies that use the Secure Plus protection model.

    • mspSecureExtraMonthlyUsage - the monthly usage for endpoints scanned with local engines that belong to companies that use the Secure Extra protection model.

    • mdrFoundationsMonthlyUsage, the monthly usage for the MDR Foundations service (MdrFoundations).

    • emailSecurityMonthlyUsage, the monthly usage (mailboxes) for Email Security (mailboxes).

    • mobileSecurityMonthlyUsage, the monthly usage for Mobile Security (devices).

    • exchangeMonthlyUsage, the monthly usage (mailboxes) for Exchange Protection.

    • encryptionMonthlyUsage, the monthly usage for Full Disk Encryption.

    • atsMonthlyUsage, the monthly usage for the Sandbox Analyzer and HyperDetect.

    • edrMonthlyUsage, the monthly usage for the Endpoint Detection and Response (EDR).

    • containerProtectionMonthlyUsage, the monthly usage for Container Protection.

    • integrityMonitoringUsage - the total number of endpoints that make use of Integrity Monitoring.

    • integrityMonitoring90DaysUsage - the number of endpoints that make use of Integrity Monitoring with 90 days event retention.

    • integrityMonitoring180DaysUsage - the number of endpoints that make use of Integrity Monitoring with 180 days event retention.

    • integrityMonitoring1YearUsage - the number of endpoints that make use of Integrity Monitoring with 1 year event retention.

    • xdrIdentitySensorsMonthlyUsage, the monthly usage of Azure AD and Active Directory integration in Sensors Management.

    • xdrProductivitySensorsMonthlyUsage, the monthly usage of Office 365 integration in Sensors Management.

    • xdrNetworkSensorsMonthlyUsage, the monthly usage of Network Sensor integration in Sensors Management.

    • xdrCloudSensorsMonthlyUsage, the monthly usage of AWS integration in Sensors Management.

    • patchManagementMonthlyUsage, the monthly usage for Patch Management.

    • sveVsMonthlyUsage, the monthly usage for virtual servers scanned with Security Server.

    • sveVdiMonthlyUsage, the monthly service usage (in hours) for virtual desktops scanned with Security Server.

    For Bitdefender EDR, the object contains the following members:

    • productType, the product type.

    • endpointMonthlyUsage, the monthly usage for endpoints scanned with local engines.

    • mdrFoundationsMonthlyUsage, the monthly usage for the MDR Foundations service (MdrFoundations).

  • minimumUsage - An Object containing types of licenses and the minimum number of slots which the company commits through legal agreement to use on a monthly basis:

    • endpointMonthlyUsage, the minimum number of endpoints that the client agreed to use from the main license.

    If the queried company does not have a monthly license or subscription, the method returns 0.

Example

Request:

  {
       "params": {
           "targetMonth": "03/2015",
           "companyId": "55115935b1a43dcc4a7b23c6"
       },
       "jsonrpc": "2.0",
       "method": "getMonthlyUsagePerProductType",
       "id": "5087eab8-b74f-4a3e-85b3-4271e85890d4"
  }  

Response:

{
  "result": {
    "usages": [
      {
        "endpointMonthlyUsage": 3,
        "encryptionMonthlyUsage": 0,
        "atsMonthlyUsage": 0,
        "edrMonthlyUsage": 0,
        "mdrFoundationsMonthlyUsage": 0,
        "patchManagementMonthlyUsage": 0,
        "integrityMonitoringUsage": 0,
        "integrityMonitoring90DaysUsage": 0,
        "integrityMonitoring180DaysUsage": 0,
        "integrityMonitoring1YearUsage": 0,
        "sveVsMonthlyUsage": 0,
        "sveVdiMonthlyUsage": 0,
        "emailSecurityMonthlyUsage": 0,
        "mobileSecurityMonthlyUsage": 0,
        "exchangeMonthlyUsage": 0,
        "containerProtectionMonthlyUsage": 0,
        "xdrIdentitySensorsMonthlyUsage": 0,
        "xdrProductivitySensorsMonthlyUsage": 0,
        "xdrNetworkSensorsMonthlyUsage": 0,
        "xdrCloudSensorsMonthlyUsage": 0,
        "productType": 0,
        "aLaCarteMonthlyUsage": 0,
        "mspSecureMonthlyUsage": 3,
        "mspSecurePlusMonthlyUsage": 0,
        "mspSecureExtraMonthlyUsage": 0
      },
      {
        "endpointMonthlyUsage": 0,
        "mdrFoundationsMonthlyUsage": 0,
        "productType": 3
      }
    ]
  },
  "jsonrpc": "2.0",
  "id": "2821",
  "error": null
}