List Antivirus Update Check History

Base URL

https://{SERVER}/api/?apikey={yourAPIkey}&service=list_av_history

Description

List status of Antivirus Update Checks on device for last 60 days.

Note:

The starting date for the response will be the current day within the account timezone.
Only currently active checks are considered. Once a check is deleted, its historical data will not be available.
For checks that have been added within the last 60 days and run at least once, PASS will be returned for the days prior to the initial run, assuming the device was online on that day.
For checks that are added and have yet to run, NOTRUN will be returned for all days.
Empty **checks **and **days **elements will be returned when there are no active antivirus checks configured for a device.
In cases when more than one Antivirus Update Check is configured to run on a device, the status reported will be the most significant status of all Antivirus Update Checks on that day. See Example Response for more detail.

Parameters

Required parameters

Add required parameters immediately after the base URL.

https://{SERVER}/api/?apikey={yourAPIkey}&service=list_av_history&required_parameters={parameter-value}

Parameter	Description	Type	Options	Default
deviceid	The deviceid must be a valid id.	string	0	0

Optional parameters

Add optional parameters after the required parameters in the base URL.

https://{SERVER}/api/?apikey={yourAPIkey}&service=list_av_history&required_parameters={parameter-value}&optional_parameters={parameter-value}

Parameter	Description	Type	Options	Default
describe	Optional. Returns a description of the entered call, the available parameters, an example of its output, and returned fields with descriptions.	boolean	true	0

Determine parameter values

Use the following associated service calls to determine parameter values.

Parameter	Call	URL Format
deviceid	list_devices_at_client	https://{SERVER}/api/?apikey={yourAPIkey}&service=list_devices_at_client&clientid=CLIENTID&devicetype=server
	list_servers	https://{SERVER}/api/?apikey=yourAPIkey&service=list_servers&siteid=SITEID
	list_workstations	https://{SERVER}/api/?apikey=yourAPIkey&service=list_workstations&siteid=SITEID

Examples

List Antivirus Update Check History

https://{SERVER}/api/?apikey={yourAPIkey}&service=get_alist_av_history&deviceid=DEVICEID

Example response

<?xml version="1.0" ?>
<result created="2014-08-04T15:29:15+01:00" host="SERVER" status="OK">
  <checks>
    <name>Antivirus Update Check Windows Defender Antispyware</name>
  </checks>
  <days>
    <day>
      <date>2014-05-06</date>
      <status>NOTINSTALLED</status>
    </day>
  </days>
  <days>
    <day>
      <date>2014-05-07</date>
      <status>PASS</status>
    </day>
  </days>
  <days>
    <day>
      <date>2014-05-08</date>
      <status>FAIL</status>
    </day>
  </days>
  <days>
    <day>
      <date>2014-05-09</date>
      <status>PASS</status>
    </day>
  </days>
  <days>
    <day>
      <date>2014-05-10</date>
      <status>FAILINACTIVE</status>
    </day>
  </days>
  <days>
    <day>
      <date>2014-05-11</date>
      <status>DEVICEOVERDUE</status>
    </day>
  </days>
  <days>
    <day>
      <date>2014-05-12</date>
      <status>NOTINSTALLED</status>
    </day>
  </days>
  ...
</result>

Returned fields

Field	Type	Can Be Empty	Description
checks/name	string	no	Name of the antivirus check (if any) running on this device. A name element will exist for each active check
days/day/date	date	no	Time data for the Checks
days/day/status	string	no	Status of the Antivirus Check(s) on that day. Can be one of the following values. If there is more than one Antivirus Check configured to run on the device, the status value will be the highest ranked value from the list below. So for example, if one check is marked as PASS for that day, and another is marked as FAIL, the status returned will be FAIL. NOTINSTALLED: Device had yet to be installed on the day NOTRUN: Check has never run on the device. In this scenario, NOTRUN will be present on each day PASSINACTIVE: Last check run was PASS, but the check did not run on the day for one of the following reasons: The device was offline at the time the check should have ran The check was not configured to run on that particular day</li> PASS: Check passed CLEAREDINACTIVE: The check was previously CLEARED, but did not run on the day for the same reasons listed in PASSINACTIVE CLEARED: The check failed but was cleared (acknowledged) FAILINACTIVE: Last check run was FAIL, but the check did not run on the day for one of the reasons listed in PASSINACTIVE FAIL: Check failed OVERDUE: The device was marked on overdue on that day (applies to Servers only)

Field

Type

Can Be Empty

Description

checks/name

string

Name of the antivirus check (if any) running on this device. A name element will exist for each active check

days/day/date

date

Time data for the Checks

days/day/status

string

Status of the Antivirus Check(s) on that day. Can be one of the following values. If there is more than one Antivirus Check configured to run on the device, the status value will be the highest ranked value from the list below. So for example, if one check is marked as PASS for that day, and another is marked as FAIL, the status returned will be FAIL.

NOTINSTALLED: Device had yet to be installed on the day

NOTRUN: Check has never run on the device. In this scenario, NOTRUN will be present on each day

PASSINACTIVE: Last check run was PASS, but the check did not run on the day for one of the following reasons:

The device was offline at the time the check should have ran
The check was not configured to run on that particular day</li>

PASS: Check passed

CLEAREDINACTIVE: The check was previously CLEARED, but did not run on the day for the same reasons listed in PASSINACTIVE

CLEARED: The check failed but was cleared (acknowledged)

FAILINACTIVE: Last check run was FAIL, but the check did not run on the day for one of the reasons listed in PASSINACTIVE

FAIL: Check failed

OVERDUE: The device was marked on overdue on that day (applies to Servers only)