List Antivirus Definitions

Base URL

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

Description

Lists the most recent definition versions and date released for a given antivirus product. By default shows up to the last 20 versions.

Parameters

Required parameters

Add required parameters immediately after the base URL.

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

Parameter	Description	Type	Options	Default
product	Antivirus product ID as returned by list_supported_av_products in the id field. For example: id = mcafee	string	0	0

Parameter

Description

Type

Options

Default

product

Antivirus product ID as returned by list_supported_av_products in the id field.

For example: id = mcafee

string

Optional parameters

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

https://{SERVER}/api/?apikey={yourAPIkey}&service=list_av_definitions&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
max_results	Maximum number of definitions to return.	integer	0	20

Determine parameter values

Use the following associated service calls to determine parameter values.

Parameter	Call	URL Format
product	list_supported_av_products	https://{SERVER}/api/?apikey={yourAPIkey}&service=list_supported_av_products

Examples

List Antivirus definitions for an antivirus product

https://{SERVER}/api/?apikey={yourAPIkey}&service=list_av_definitions&product=ANTIVIRUS_PRODUCT_ID&max_results=NUMBER

Example response

<?xml version="1.0" ?>
<result created="2009-09-24T12:28:44+01:00" host="SERVER" status="OK">
<definitions>
  <definition>
    <product>kaspesky</product>
    <version>26092006 1858 </version>
       <date>2006-09-26 17:55:34 </date>
  </ definition >
  < definition >
 </ definition >
  </products>
</result>

Returned fields

Field	Type	Can Be Empty	Description
product	string	no	The product Id.
version	string	no	The definition version of the product.
date	date	no	The date and time this definition was released.