List scans
GET {{baseUrl}}/scans?folder_id=67454373&last_modification_date=67454373
Returns a list of scans where you have at least CAN VIEW [16] permissions.
Note: Keep in mind potential rate limits when using this endpoint. To check the status of your scans, use the GET /scans/{scan_id}/latest-status endpoint. Tenable recommends the GET /scans/{scan_id}/latest-status endpoint especially if you are programmatically checking the status of large numbers of scans.
Requires BASIC [16] user permissions and CAN VIEW [16] scan permissions. See Permissions.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
folder_id | number | The ID of the folder where the scans you want to list are stored. | |
last_modification_date | number | Limit the results to those scans that have run since the specified time. This parameter does not represent the date on which the scan configuration was last modified. Must be in Unix time format. |
RESPONSES
status: OK
{"folders":[{"unread_count":0,"custom":0,"default_tag":0,"type":"trash","name":"Trash","id":8},{"unread_count":0,"custom":0,"default_tag":1,"type":"main","name":"My Scans","id":9}],"scans":[{"legacy":false,"permissions":128,"type":null,"read":true,"last_modification_date":1430934526,"creation_date":1430933086,"status":"imported","uuid":"2776e999-1f5b-45b9-2e15-65a7be35b2e3ab8f7ecb158c480e","shared":false,"user_permissions":128,"owner":"user2@example.com","schedule_uuid":"0fafc7a8-c5f6-fe9d-68b9-4d60ab0d9d2cf60557ee0e264228","timezone":null,"rrules":null,"starttime":null,"enabled":false,"control":false,"name":"KitchenSinkScan","id":11},{"permissions":128,"type":null,"read":true,"last_modification_date":0,"creation_date":0,"status":"empty","uuid":null,"shared":false,"user_permissions":128,"owner":"user2@example.com","schedule_uuid":"template-c311aa94-82d0-7827-6c71-72978df15544f4f660ba792e0b0f","timezone":"US/Central","rrules":null,"starttime":null,"enabled":true,"control":true,"name":"Full Network Scan","id":26},{"permissions":128,"type":null,"read":true,"last_modification_date":0,"creation_date":0,"status":"empty","uuid":null,"shared":false,"user_permissions":128,"owner":"user2@example.com","schedule_uuid":"template-5f050b0a-6be6-1eb8-68dc-5a2f459ec7f710499ad7667391df","timezone":null,"rrules":null,"starttime":null,"enabled":false,"control":true,"name":"test-scan-2","id":25},{"permissions":128,"type":null,"read":true,"last_modification_date":0,"creation_date":0,"status":"empty","uuid":null,"shared":false,"user_permissions":128,"owner":"user2@example.com","schedule_uuid":"template-95626145-6b38-96bc-238f-148b1353910d0c27f2a930c2c843","timezone":null,"rrules":null,"starttime":null,"enabled":false,"control":true,"name":"test-scan","id":23},{"permissions":128,"type":null,"read":true,"last_modification_date":0,"creation_date":0,"status":"empty","uuid":null,"shared":false,"user_permissions":128,"owner":"user2@example.com","schedule_uuid":"template-ac665a85-2fca-f34c-9294-9bdc5bc925aee1c068e70183409e","timezone":null,"rrules":null,"starttime":null,"enabled":false,"control":true,"name":"basic Scan","id":21}],"timestamp":1544146142}