Search scans
POST {{baseUrl}}/was/v2/configs/:config_id/scans/search?limit=-54086346&offset=-54086346&sort=last_seen:desc,ipv4:asc
Returns a list of scans.
Requires BASIC [16] 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 10. | |
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, name:desc would sort results by the name field in descending order. |
If you specify multiple fields, the fields must be separated by commas. For example, name:desc,created_at:asc would first sort results by the name field in descending order and then by the created_at field in ascending order. |
Request Body
{"AND"=>[{"field"=>"folder_name", "operator"=>"match", "value"=>"My Scans"}, {"field"=>"folder_name", "operator"=>"match", "value"=>"My Scans"}], "OR"=>[{"field"=>"folder_name", "operator"=>"match", "value"=>"My Scans"}, {"field"=>"folder_name", "operator"=>"match", "value"=>"My Scans"}]}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Content-Type | string |
RESPONSES
status: OK
{"page_number":0,"page_size":10,"order_by":"created_at","ordering":"desc","sort":[{"name":"created_at","order":"desc"}],"total_size":2098,"data":[{"scan_id":"cd8a58db-af6c-47b3-b402-dd34021fa419","user_id":"5ff4ad03-f168-4632-90fb-babf376579e9","config_id":"e65230e0-9ca3-473a-8310-f2a3fd971b90","asset_id":"6febe7b0-5dc0-43ec-afc1-aa8a7a6a7ae5","target":"http://example.com/","application_uri":"http://example.com/","created_at":"2020-12-07T20:00:14.319827Z","updated_at":"2020-12-07T20:01:19.815217Z","started_at":"2020-12-07T20:01:00.386897Z","finalized_at":"2020-12-07T20:01:19.808199Z","requested_action":"start","status":"completed","metadata":{"found_urls":1,"queued_urls":0,"scan_status":"running","audited_urls":1,"queued_pages":0,"audited_pages":1,"request_count":163,"response_time":0},"scanner":{"group_name":"US Cloud Scanner"},"template_name":"config_audit"},{"scan_id":"03feb368-b9d9-4323-b2d6-731e7a34ab5a","user_id":"5ff4ad03-f168-4632-90fb-babf376579e9","config_id":"25d3246b-805b-3ace-9263-3224579646bf","asset_id":"22807f4e-d678-4c60-bcb9-6af2a0623f9b","target":"http://192.0.2.119/","application_uri":"http://192.0.2.119/","created_at":"2020-12-07T14:30:41.342350Z","updated_at":"2020-12-07T18:30:49.565002Z","started_at":null,"finalized_at":"2020-12-07T18:30:49.508707Z","requested_action":"start","status":"aborted","metadata":null,"scanner":null,"template_name":"scan"},{"scan_id":"e63798b0-b006-4961-85f2-daec26ee293c","user_id":"5ff4ad03-f168-4632-90fb-babf376579e9","config_id":"34f9e5c8-9c73-39fe-bc14-837316aa8fc4","asset_id":"22807f4e-d678-4c60-bcb9-6af2a0623f9b","target":"http://192.0.2.119/","application_uri":"http://192.0.2.119/","created_at":"2020-12-07T14:30:41.246525Z","updated_at":"2020-12-07T14:41:49.778380Z","started_at":"2020-12-07T14:31:20.876292Z","finalized_at":"2020-12-07T14:41:49.766614Z","requested_action":"start","status":"completed","metadata":{"found_urls":26,"queued_urls":0,"scan_status":"running","audited_urls":11,"queued_pages":0,"audited_pages":18,"request_count":2725,"response_time":0},"scanner":{"group_name":"US Cloud Scanner"},"template_name":"scan"},{"scan_id":"997fcf60-02cb-48c8-b7c9-893412455188","user_id":"5ff4ad03-f168-4632-90fb-babf376579e9","config_id":"d7ab3a9d-0931-3868-a53a-d6bcacf8def3","asset_id":"22807f4e-d678-4c60-bcb9-6af2a0623f9b","target":"https://192.0.2.119","application_uri":"https://192.0.2.119","created_at":"2020-12-07T12:00:28.818222Z","updated_at":"2020-12-07T12:00:53.051974Z","started_at":"2020-12-07T12:00:47.479393Z","finalized_at":"2020-12-07T12:00:53.032269Z","requested_action":"start","status":"aborted","metadata":null,"scanner":{"group_name":"US Cloud Scanner"},"template_name":"scan"},{"scan_id":"b621f353-37c0-4506-941c-9accf920d443","user_id":"5ff4ad03-f168-4632-90fb-babf376579e9","config_id":"3eb241c8-5549-4a8d-90ca-a49033d897f9","asset_id":"22807f4e-d678-4c60-bcb9-6af2a0623f9b","target":"http://192.0.2.119/","application_uri":"http://192.0.2.119/","created_at":"2020-12-07T12:00:28.731409Z","updated_at":"2020-12-07T12:11:23.354890Z","started_at":"2020-12-07T12:00:46.467506Z","finalized_at":"2020-12-07T12:11:23.339756Z","requested_action":"start","status":"completed","metadata":{"found_urls":48,"queued_urls":0,"scan_status":"running","audited_urls":23,"queued_pages":0,"audited_pages":30,"request_count":4333,"response_time":0},"scanner":{"group_name":"US Cloud Scanner"},"template_name":"scan"},{"scan_id":"cc1fa91b-e942-4d2b-bc56-29986132e476","user_id":"5ff4ad03-f168-4632-90fb-babf376579e9","config_id":"e65230e0-9ca3-473a-8310-f2a3fd971b90","asset_id":"6febe7b0-5dc0-43ec-afc1-aa8a7a6a7ae5","target":"http://example.com/","application_uri":"http://example.com/","created_at":"2020-12-06T20:00:46.137448Z","updated_at":"2020-12-06T20:01:18.982088Z","started_at":"2020-12-06T20:01:00.475819Z","finalized_at":"2020-12-06T20:01:18.977261Z","requested_action":"start","status":"completed","metadata":{"found_urls":1,"queued_urls":0,"scan_status":"running","audited_urls":1,"queued_pages":0,"audited_pages":1,"request_count":163,"response_time":0},"scanner":{"group_name":"US Cloud Scanner"},"template_name":"config_audit"},{"scan_id":"51cd8c34-2f95-45ef-95f3-324c8044826d","user_id":"5ff4ad03-f168-4632-90fb-babf376579e9","config_id":"e65230e0-9ca3-473a-8310-f2a3fd971b90","asset_id":"6febe7b0-5dc0-43ec-afc1-aa8a7a6a7ae5","target":"http://example.com/","application_uri":"http://example.com/","created_at":"2020-12-05T20:00:18.679060Z","updated_at":"2020-12-05T20:00:53.905932Z","started_at":"2020-12-05T20:00:35.450322Z","finalized_at":"2020-12-05T20:00:53.899011Z","requested_action":"start","status":"completed","metadata":{"found_urls":1,"queued_urls":0,"scan_status":"running","audited_urls":1,"queued_pages":0,"audited_pages":1,"request_count":163,"response_time":0},"scanner":{"group_name":"US Cloud Scanner"},"template_name":"config_audit"},{"scan_id":"c19ba6b4-8640-46a9-8789-e4b5569205e6","user_id":"5ff4ad03-f168-4632-90fb-babf376579e9","config_id":"e65230e0-9ca3-473a-8310-f2a3fd971b90","asset_id":"6febe7b0-5dc0-43ec-afc1-aa8a7a6a7ae5","target":"http://example.com/","application_uri":"http://example.com/","created_at":"2020-12-04T20:00:20.058359Z","updated_at":"2020-12-04T20:01:34.843822Z","started_at":"2020-12-04T20:01:15.837083Z","finalized_at":"2020-12-04T20:01:34.831731Z","requested_action":"start","status":"completed","metadata":{"found_urls":1,"queued_urls":0,"scan_status":"running","audited_urls":1,"queued_pages":0,"audited_pages":1,"request_count":162,"response_time":0},"scanner":{"group_name":"US Cloud Scanner"},"template_name":"config_audit"},{"scan_id":"6b63cc79-38f7-4861-889e-3cf17ab86916","user_id":"5ff4ad03-f168-4632-90fb-babf376579e9","config_id":"3eb241c8-5549-4a8d-90ca-a49033d897f9","asset_id":"22807f4e-d678-4c60-bcb9-6af2a0623f9b","target":"http://192.0.2.119/","application_uri":"http://192.0.2.119/","created_at":"2020-12-04T12:00:39.733492Z","updated_at":"2020-12-04T12:11:32.035955Z","started_at":"2020-12-04T12:00:56.278028Z","finalized_at":"2020-12-04T12:11:32.029569Z","requested_action":"start","status":"completed","metadata":{"found_urls":48,"queued_urls":0,"scan_status":"running","audited_urls":23,"queued_pages":0,"audited_pages":30,"request_count":4248,"response_time":0},"scanner":{"group_name":"US Cloud Scanner"},"template_name":"scan"},{"scan_id":"543dbdad-0402-4f8b-9ebc-ec8ddd0801d6","user_id":"5ff4ad03-f168-4632-90fb-babf376579e9","config_id":"e65230e0-9ca3-473a-8310-f2a3fd971b90","asset_id":"6febe7b0-5dc0-43ec-afc1-aa8a7a6a7ae5","target":"http://example.com/","application_uri":"http://example.com/","created_at":"2020-12-03T20:00:23.578614Z","updated_at":"2020-12-03T20:01:25.441773Z","started_at":"2020-12-03T20:01:06.985067Z","finalized_at":"2020-12-03T20:01:25.434118Z","requested_action":"start","status":"completed","metadata":{"found_urls":1,"queued_urls":0,"scan_status":"running","audited_urls":1,"queued_pages":0,"audited_pages":1,"request_count":162,"response_time":0},"scanner":{"group_name":"US Cloud Scanner"},"template_name":"config_audit"}],"pagination":{"total":2098,"offset":0,"limit":10,"sort":[{"name":"created_at","order":"desc"}]},"items":[{"scan_id":"cd8a58db-af6c-47b3-b402-dd34021fa419","user_id":"5ff4ad03-f168-4632-90fb-babf376579e9","config_id":"e65230e0-9ca3-473a-8310-f2a3fd971b90","asset_id":"6febe7b0-5dc0-43ec-afc1-aa8a7a6a7ae5","target":"http://example.com/","application_uri":"http://example.com/","created_at":"2020-12-07T20:00:14.319827Z","updated_at":"2020-12-07T20:01:19.815217Z","started_at":"2020-12-07T20:01:00.386897Z","finalized_at":"2020-12-07T20:01:19.808199Z","requested_action":"start","status":"completed","metadata":{"found_urls":1,"queued_urls":0,"scan_status":"running","audited_urls":1,"queued_pages":0,"audited_pages":1,"request_count":163,"response_time":0},"scanner":{"group_name":"US Cloud Scanner"},"template_name":"config_audit"},{"scan_id":"03feb368-b9d9-4323-b2d6-731e7a34ab5a","user_id":"5ff4ad03-f168-4632-90fb-babf376579e9","config_id":"25d3246b-805b-3ace-9263-3224579646bf","asset_id":"22807f4e-d678-4c60-bcb9-6af2a0623f9b","target":"http://192.0.2.119/","application_uri":"http://192.0.2.119/","created_at":"2020-12-07T14:30:41.342350Z","updated_at":"2020-12-07T18:30:49.565002Z","started_at":null,"finalized_at":"2020-12-07T18:30:49.508707Z","requested_action":"start","status":"aborted","metadata":null,"scanner":null,"template_name":"scan"},{"scan_id":"e63798b0-b006-4961-85f2-daec26ee293c","user_id":"5ff4ad03-f168-4632-90fb-babf376579e9","config_id":"34f9e5c8-9c73-39fe-bc14-837316aa8fc4","asset_id":"22807f4e-d678-4c60-bcb9-6af2a0623f9b","target":"http://192.0.2.119/","application_uri":"http://192.0.2.119/","created_at":"2020-12-07T14:30:41.246525Z","updated_at":"2020-12-07T14:41:49.778380Z","started_at":"2020-12-07T14:31:20.876292Z","finalized_at":"2020-12-07T14:41:49.766614Z","requested_action":"start","status":"completed","metadata":{"found_urls":26,"queued_urls":0,"scan_status":"running","audited_urls":11,"queued_pages":0,"audited_pages":18,"request_count":2725,"response_time":0},"scanner":{"group_name":"US Cloud Scanner"},"template_name":"scan"},{"scan_id":"997fcf60-02cb-48c8-b7c9-893412455188","user_id":"5ff4ad03-f168-4632-90fb-babf376579e9","config_id":"d7ab3a9d-0931-3868-a53a-d6bcacf8def3","asset_id":"22807f4e-d678-4c60-bcb9-6af2a0623f9b","target":"https://192.0.2.119","application_uri":"https://192.0.2.119","created_at":"2020-12-07T12:00:28.818222Z","updated_at":"2020-12-07T12:00:53.051974Z","started_at":"2020-12-07T12:00:47.479393Z","finalized_at":"2020-12-07T12:00:53.032269Z","requested_action":"start","status":"aborted","metadata":null,"scanner":{"group_name":"US Cloud Scanner"},"template_name":"scan"},{"scan_id":"b621f353-37c0-4506-941c-9accf920d443","user_id":"5ff4ad03-f168-4632-90fb-babf376579e9","config_id":"3eb241c8-5549-4a8d-90ca-a49033d897f9","asset_id":"22807f4e-d678-4c60-bcb9-6af2a0623f9b","target":"http://192.0.2.119/","application_uri":"http://192.0.2.119/","created_at":"2020-12-07T12:00:28.731409Z","updated_at":"2020-12-07T12:11:23.354890Z","started_at":"2020-12-07T12:00:46.467506Z","finalized_at":"2020-12-07T12:11:23.339756Z","requested_action":"start","status":"completed","metadata":{"found_urls":48,"queued_urls":0,"scan_status":"running","audited_urls":23,"queued_pages":0,"audited_pages":30,"request_count":4333,"response_time":0},"scanner":{"group_name":"US Cloud Scanner"},"template_name":"scan"},{"scan_id":"cc1fa91b-e942-4d2b-bc56-29986132e476","user_id":"5ff4ad03-f168-4632-90fb-babf376579e9","config_id":"e65230e0-9ca3-473a-8310-f2a3fd971b90","asset_id":"6febe7b0-5dc0-43ec-afc1-aa8a7a6a7ae5","target":"http://example.com/","application_uri":"http://example.com/","created_at":"2020-12-06T20:00:46.137448Z","updated_at":"2020-12-06T20:01:18.982088Z","started_at":"2020-12-06T20:01:00.475819Z","finalized_at":"2020-12-06T20:01:18.977261Z","requested_action":"start","status":"completed","metadata":{"found_urls":1,"queued_urls":0,"scan_status":"running","audited_urls":1,"queued_pages":0,"audited_pages":1,"request_count":163,"response_time":0},"scanner":{"group_name":"US Cloud Scanner"},"template_name":"config_audit"},{"scan_id":"51cd8c34-2f95-45ef-95f3-324c8044826d","user_id":"5ff4ad03-f168-4632-90fb-babf376579e9","config_id":"e65230e0-9ca3-473a-8310-f2a3fd971b90","asset_id":"6febe7b0-5dc0-43ec-afc1-aa8a7a6a7ae5","target":"http://example.com/","application_uri":"http://example.com/","created_at":"2020-12-05T20:00:18.679060Z","updated_at":"2020-12-05T20:00:53.905932Z","started_at":"2020-12-05T20:00:35.450322Z","finalized_at":"2020-12-05T20:00:53.899011Z","requested_action":"start","status":"completed","metadata":{"found_urls":1,"queued_urls":0,"scan_status":"running","audited_urls":1,"queued_pages":0,"audited_pages":1,"request_count":163,"response_time":0},"scanner":{"group_name":"US Cloud Scanner"},"template_name":"config_audit"},{"scan_id":"c19ba6b4-8640-46a9-8789-e4b5569205e6","user_id":"5ff4ad03-f168-4632-90fb-babf376579e9","config_id":"e65230e0-9ca3-473a-8310-f2a3fd971b90","asset_id":"6febe7b0-5dc0-43ec-afc1-aa8a7a6a7ae5","target":"http://example.com/","application_uri":"http://example.com/","created_at":"2020-12-04T20:00:20.058359Z","updated_at":"2020-12-04T20:01:34.843822Z","started_at":"2020-12-04T20:01:15.837083Z","finalized_at":"2020-12-04T20:01:34.831731Z","requested_action":"start","status":"completed","metadata":{"found_urls":1,"queued_urls":0,"scan_status":"running","audited_urls":1,"queued_pages":0,"audited_pages":1,"request_count":162,"response_time":0},"scanner":{"group_name":"US Cloud Scanner"},"template_name":"config_audit"},{"scan_id":"6b63cc79-38f7-4861-889e-3cf17ab86916","user_id":"5ff4ad03-f168-4632-90fb-babf376579e9","config_id":"3eb241c8-5549-4a8d-90ca-a49033d897f9","asset_id":"22807f4e-d678-4c60-bcb9-6af2a0623f9b","target":"http://192.0.2.119/","application_uri":"http://192.0.2.119/","created_at":"2020-12-04T12:00:39.733492Z","updated_at":"2020-12-04T12:11:32.035955Z","started_at":"2020-12-04T12:00:56.278028Z","finalized_at":"2020-12-04T12:11:32.029569Z","requested_action":"start","status":"completed","metadata":{"found_urls":48,"queued_urls":0,"scan_status":"running","audited_urls":23,"queued_pages":0,"audited_pages":30,"request_count":4248,"response_time":0},"scanner":{"group_name":"US Cloud Scanner"},"template_name":"scan"},{"scan_id":"543dbdad-0402-4f8b-9ebc-ec8ddd0801d6","user_id":"5ff4ad03-f168-4632-90fb-babf376579e9","config_id":"e65230e0-9ca3-473a-8310-f2a3fd971b90","asset_id":"6febe7b0-5dc0-43ec-afc1-aa8a7a6a7ae5","target":"http://example.com/","application_uri":"http://example.com/","created_at":"2020-12-03T20:00:23.578614Z","updated_at":"2020-12-03T20:01:25.441773Z","started_at":"2020-12-03T20:01:06.985067Z","finalized_at":"2020-12-03T20:01:25.434118Z","requested_action":"start","status":"completed","metadata":{"found_urls":1,"queued_urls":0,"scan_status":"running","audited_urls":1,"queued_pages":0,"audited_pages":1,"request_count":162,"response_time":0},"scanner":{"group_name":"US Cloud Scanner"},"template_name":"config_audit"}]}