---
updatedAt: 2025-08-14T13:41:22.000Z
agentTools:
  siteIndex: https://developer.n-able.com/llms.txt
  projectIndex: https://developer.n-able.com/n-sight/llms.txt
---

# Get Antivirus Definition Release Date

Service name: get_av_definition_release_date

## Base URL

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

## Description

Given an antivirus product ID and a definition version, returns the date and time a definition was released.

## Parameters

### Required parameters

Add required parameters immediately after the base URL.

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

<Table align={["left","left","left","left","left"]}>
  <thead>
    <tr>
      <th>
        Parameter
      </th>

      <th>
        Description
      </th>

      <th>
        Type
      </th>

      <th>
        Options
      </th>

      <th>
        Default
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        product
      </td>

      <td>
        Antivirus product ID as returned by the list\_supported\_av\_products call in the **id** field.  

        For example:  id = mcafee
      </td>

      <td>
        string
      </td>

      <td>
        0
      </td>

      <td>
        0
      </td>
    </tr>

    <tr>
      <td>
        version
      </td>

      <td>
        Antivirus definition version as returned by the list\_supported\_av\_products call in the **version**field.
      </td>

      <td>
        string
      </td>

      <td>
        0
      </td>

      <td>
        0
      </td>
    </tr>
  </tbody>
</Table>

### Optional parameters

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

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

| Parameter                      | Description                                                                                                                                     | Type    | Options | Default |
| :----------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------- | :------ | :------ | :------ |
| [describe](describe-parameter) | 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                                                                          |
| :-------- | :---------------------------------------------------------- | :---------------------------------------------------------------------------------- |
| product   | [list\_supported\_av\_products](list-supported-av-products) | https\://\{SERVER}/api/?apikey=\{yourAPIkey}\&service=list\_supported\_av\_products |
| version   | [list\_av\_definitions](list-av-definitions)                | https\://\{SERVER}/api/?apikey=\{yourAPIkey}\&service=list\_av\_definitions         |

## Examples

### Get the antivirus definition release date

```
https://{SERVER}/api/?apikey={yourAPIkey}&service=get_av_definition_release_date&product=ANTIVIRUS_PRODUCT_ID&version=VERSION
```

#### Example response

```xml
<?xml version="1.0" ?>
<result created="2015-08-04T11:05:35+01:00" host="SERVER" status="OK">
<definitions>
  <definition>
    <product>mcafee</product>
    <version>7882</version>
       <date>2015-08-03 17:10:28</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. |