Cloud Administration Retrieve License Usage API Version 2

Use the Cloud Administration Retrieve License Usage API Version 2 to retrieve the following information for the current month and previous 12 months:

• Number of MFA licenses used

• Number of users with third-party FIDO authenticators

• Number of SMS and Voice tokencodes sent

• Number of active users

Use this information to monitor for license compliance. The MFA license measures the number of users who have registered a device with the RSA Authenticator app installed. Your organization can then order additional licenses from RSA if needed.

For information about managing access to this API, see Accessing the Cloud Administration APIs.

Authentication

Clients calling this API must authenticate themselves by including a JSON Web Token in a request. For instructions on using this token, see Authentication for the Cloud Administration APIs.

Software Developer Kit

You can download the API Software Developer Kit (SDK) from Cloud Administration REST API Download.

Request Requirements

Use the following information to retrieve license usage information.

Request Example

The following example displays a REST API request to retrieve license usage information.

GET /AdminInterface/restapi/v2/licenseusage

Accept: application/json

Authorization: Bearer <JWT token>

Response Property Descriptions

The following table shows response property descriptions and data types.

Example Response

The following example shows a response.

[{"mfaLicensesUsed":0,"smsAndVoiceTokencodesSent":0,"month":"2021-02","lastUpdatedAt":"2021-02-01T20:55:45.000Z","activeUsers":1,"usersWithThirdPartyFidoAuthenticators":1},

{"mfaLicensesUsed":0,"smsAndVoiceTokencodesSent":0,"month":"2021-01","activeUsers":1,"usersWithThirdPartyFidoAuthenticators":1},

{"mfaLicensesUsed":0,"smsAndVoiceTokencodesSent":0,"month":"2020-12","activeUsers":1,"usersWithThirdPartyFidoAuthenticators":1},

{"mfaLicensesUsed":0,"smsAndVoiceTokencodesSent":0,"month":"2020-11","activeUsers":1,"usersWithThirdPartyFidoAuthenticators":1}]

Response Codes

The following table shows response codes for this API.