Get scan history

GET {{baseUrl}}/scans/:scan_id/history?limit=67454373&offset=67454373&sort=start_date:desc,status:asc

Returns a list of objects, each of which represent an individual run of the specified scan.

Requires SCAN OPERATOR [24] user permissions and CAN VIEW [16] scan permissions. See Permissions.

Request Params

KeyDatatypeRequiredDescription
limitnumberThe number of records to retrieve. If this parameter is omitted, Tenable.io uses the default value of 50.
offsetnumberThe starting record to retrieve. If this parameter is omitted, Tenable.io uses the default value of 0.
sortstringThe field you want to use to sort the results by along with the sort order. The field is specified first, followed by a colon, and the order is specified second (asc or desc). For example, start_date:desc would sort results by the start_date field in descending order.

If you specify multiple fields, the fields must be separated by commas. For example, start_date:desc,status:asc would first sort results by the start_date field in descending order and then by the status field in ascending order. |

RESPONSES

status: OK

{"pagination":{"offset":0,"total":8,"sort":[{"order":"DESC","name":"start_date"}],"limit":50},"history":[{"time_end":1545945607,"scan_uuid":"1732621d-a7c3-4295-bbc9-37035112ff0a","id":10535512,"is_archived":true,"time_start":1545945482,"visibility":"public","targets":{"custom":false,"default":null},"status":"canceled"},{"time_end":1545945457,"scan_uuid":"cd5c32e9-0b66-4c31-b61a-8d1bdd8a67ad","id":10535505,"is_archived":true,"time_start":1545945321,"visibility":"public","targets":{"custom":false,"default":null},"status":"completed"},{"time_end":1545944767,"scan_uuid":"34e04696-2abf-4767-86cb-c51eb26a3511","id":10535496,"is_archived":true,"time_start":1545944637,"visibility":"public","targets":{"custom":false,"default":null},"status":"completed"},{"time_end":1545877987,"scan_uuid":"47ee2c49-9422-4082-9b5b-48d0883bc76e","id":10534608,"is_archived":true,"time_start":1545877843,"visibility":"public","targets":{"custom":false,"default":null},"status":"aborted"},{"time_end":1545877717,"scan_uuid":"0a20f6f1-cb6e-4947-ab71-8121dddff8e9","id":10534601,"is_archived":true,"time_start":1545877590,"visibility":"public","targets":{"custom":false,"default":null},"status":"aborted"},{"time_end":1545877057,"scan_uuid":"2b346502-d769-452e-9c2e-0c50033852d2","id":10534598,"is_archived":true,"time_start":1545876907,"visibility":"public","targets":{"custom":false,"default":null},"status":"aborted"},{"time_end":1545871897,"scan_uuid":"e80fa271-8a6e-44e8-bdcf-dc75274d4b25","id":10534540,"is_archived":true,"time_start":1545871758,"visibility":"public","targets":{"custom":false,"default":null},"status":"aborted"},{"time_end":1545871177,"scan_uuid":"36984557-946d-4858-8af7-ded422fee78b","id":10534536,"is_archived":true,"time_start":1545871035,"visibility":"public","targets":{"custom":false,"default":null},"status":"aborted"}]}