Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Currently, the The License Statistics API lets you generate data from the User historyHistory report. This report shows statistics for license usage per user, during any period that usage was tracked.

Showing sessions at a specific point in time

If you want to retrieve information about usage history at a particular point in time, we recommend that you use the following URL request template.

...

FieldTypeDescription
uidintegerUser Id.
unstringUsername.
hnstringHostname.
sststringDate returned in YYYY-MM-DD HH:MM format; for example, 2016-01-20 11:00.
setstringDate returned in YYYY-MM-DD HH:MM format (for example, 2016-01-20 11:00), "Unknown", or "Still in use".
ilbooleanThis field indicates whether user details have been imported from LDAP directory. Note that currently you cannot filter and order data by this field.
messagestringError message returned on failure.

...

Code Block
languagejs
firstline1
linenumberstrue
  curl --data "limit=100" --data "offset=0" --data-urlencode "sdt=2015-10-30 00:00" -H "X-Auth-token: token" "http://yourdomain/api/report/user-history/3/json"

Showing sessions over a specific time period

If you want to retrieve information about usage history over a specific period of time, we recommend that you use the following URL request template:

...

FieldTypeDescription
uidintegerUser Id.
unstringUsername.
hnstringHostname.
sststringDate returned in YYYY-MM-DD HH:MM format; for example, 2016-01-20 11:00.
setstringDate returned in YYYY-MM-DD HH:MM format (for example, 2016-01-20 11:00), "Unknown", or "Still in use".
ilbooleanThis field indicates whether user details have been imported from LDAP directory. Note that currently you cannot filter and order data by this field.
messagestringError message returned on failure. 

...