Fetching Engine/Database Versions

The response is an array of engines with database information.

Request

Value

Method

GET

URL

/stat/engines

Successful response

HTTP status code: 200

[
{
"active": true,
"def_time": "",
"download_progress": 100,
"download_time": "2015-08-14T15:57:46.898Z",
"eng_id": "7z_1_linux",
"eng_name": "Archive engine",
"eng_type": "Bundled engine",
"eng_ver": "9.38-57",
"engine_type": "archive",
"state": "production",
"type": "engine"
},
{
"active": true,
"def_time": "2015-08-17T02:37:05.000Z",
"download_progress": 100,
"download_time": "2015-08-17T08:17:22.810Z",
"eng_id": "clamav_1_linux",
"eng_name": "ClamAV",
"eng_type": "Bundled engine",
"eng_ver": "3.0-43",
"engine_type": "av",
"state": "production",
"type": "engine"
}
]

Response description:

  • active: if used by at least one engine

  • def_time: the database definition time for this engine

  • download_progress: percentage progress of download

  • download_time: when this engine downloaded from the update server

  • eng_id: engine internal ID

  • eng_name: engine name

  • eng_type: engine type in human readable form

  • eng_ver: engine's version

  • engine_type: engine's type (av, archive or filetype)

  • state: status of the engine (downloading, downloaded, staging, production, removed, temporary failed, permanently failed, content invalid or download failed)

Error response

Internal error

HTTP status code: 500

{
"err": "Error querying engine list"
}

Unexpected event on server

HTTP status code: 500

{
"err": "<error message>"
}