WFBSS :: Customers :: Usage :: get | Trend Micro Service Central

Views:

Last Updated: 1/22/2020 12:11:05 AM

Get seat usage of given customers.

Request

HTTP Request

GET /SMPI/{version}/service/wfbss/api/customers/usage

Parameters

Name	Type	Description	Validation
Required Parameters
cids	string	A list of customer ID separated by comma.	At least one customer ID must be specified, but no more than 20.

HTTP Request Example

Get seat usage of given customers:
GET /SMPI/{version}/service/wfbss/api/customers/usage?cids=640FE47F-5118-4D79-8221-A35D0DE2EE2C,549390C2-61B3-417E-B1F0-8955A63C08F3

Request Body

Do not supply a request body with this method.

Response

If successful, this method returns an HTTP 200 OK status code and a response body with the following structure:

{
  "customers": [
    {
      "id": "549390C2-61B3-417E-B1F0-8955A63C08F3",
      "seat_usages": [
        {
          "activationcode": "WF-Z4X5-PXKUE-JTMF7-37AJ7-SQUTD-BHWPJ",
          "update_time": 1370251511,
          "used": 200
        }
      ]
    },
    {
      "id": "640FE47F-5118-4D79-8221-A35D0DE2EE2C",
      "seat_usages": [
        {
          "activationcode": "WF-Z4X5-PXKUE-JTMF7-37AJ7-SQUTD-BHWPJ",
          "update_time": 1370251511,
          "used": 80
        }
      ]
    }
  ]
}

Name	Type	Description	Length
customers[].id	string	Customer ID	GUID
customers[].seat_usages[].activationcode	integer	Activation code
customers[].seat_usages[].update_time	integer	Timestamp of when this seat usage generated.	Unix timestamp (seconds since 1970-01-01 00:00:00 UTC)
customers[].seat_usages[].used	integer	Seats in use
customers[].eid	string	For internal use	GUID