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
Key | Datatype | Required | Description |
---|---|---|---|
limit | number | The number of records to retrieve. If this parameter is omitted, Tenable.io uses the default value of 50 . | |
offset | number | The starting record to retrieve. If this parameter is omitted, Tenable.io uses the default value of 0 . | |
sort | string | The 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"}]}