External DocumentationTo learn more, visit the Tenable documentation.
Parameters
| Parameter | Description |
|---|---|
| Limit | The number of records to retrieve. If this parameter is omitted, Tenable.io uses the default value of 10. The minimum value is 0 and the maximum value is 200. If you need to retrieve more than 200 records, use the offset value to iterate through page responses. |
| Offset | The starting record to retrieve. If this parameter is omitted, Tenable.io uses the default value of 0. |
| Sort | 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. |
Example Output
{
"value": {
"items": [
{
"attachments": [
{
"attachment_id": "cfde7d28-82f2-4733-b5d8-e003fc27a620",
"attachment_name": "configuration.csv",
"created_at": "2020-12-07T20:01:23.650014Z",
"file_type": "text/plain",
"md5": "md5:48be107f67f1cdc0e9d63a8f6cafc27e",
"size": 2184
},
{
"attachment_id": "23056170-5fcd-4b7c-9831-c62c94dd4b01",
"attachment_name": "plugins.csv",
"created_at": "2020-12-07T20:01:23.595659Z",
"file_type": "text/plain",
"md5": "md5:3ad245715cdb6856430dd1e71f7cb522",
"size": 3236
}
],
"created_at": "2020-12-07T20:01:19Z",
"details": {
"input_name": null,
"input_type": null,
"output": "\nEngine Version 1.8.0_DEVELOP_SNAPSHOT-1518\nScan ID 0d94f5b4-f811-44cb-802a-7f1c600818c3\n\nStart Time 2020-12-07 20:01:00 +0000\nDuration 00:00:17\n\nRequests 163\nRequests/s 19.6194\nMean Response Time 0.0917s\n\nBandwidth Usage\n- Data to Target 54.5 KB\n- Data from Target 43 KB\n\nTimeouts Encountered\nNetwork Timeouts 0\nBrowser Timeouts 0\n\n\nHTTP Protocols Detected\n- HTTP\n- HTTPs\n\n\nAuthentication Identified\n- None\n\n\nPlugins\n- 50 have been included per scan policy\n- 69 have been started based on target information collected\n\nList of plugins is available in 'plugins.csv' attachment.\n\n\nSettings used to conduct this scan are available in 'configuration.csv' attachment.\n",
"payload": null,
"proof": null,
"request": null,
"response": null,
"selector": null,
"selector_url": null,
"signature": null
},
"is_page": false,
"plugin_id": 98000,
"scan_id": "0d94f5b4-f811-44cb-802a-7f1c600818c3",
"uri": "http://example.com/",
"vuln_id": "240ae95d-3830-498e-8598-d44097ec64cf"
},
{
"attachments": [
{
"attachment_id": "c4429383-fcb3-4b07-8a34-eb27c85f174f",
"attachment_name": "technologies.csv",
"created_at": "2020-12-07T20:01:23.451700Z",
"file_type": "text/plain",
"md5": "md5:aa89c953c21f31a1a7b01b3cafce50ab",
"size": 254
}
],
"created_at": "2020-12-07T20:01:19Z",
"details": {
"input_name": null,
"input_type": null,
"output": "The framework has detected the following technologies in the target application:\n\n- Bootstrap (version unknown)\n- Apache (v2.4.6)",
"payload": null,
"proof": null,
"request": null,
"response": null,
"selector": null,
"selector_url": null,
"signature": null
},
"is_page": false,
"plugin_id": 98059,
"scan_id": "0d94f5b4-f811-44cb-802a-7f1c600818c3",
"uri": "http://example.com/",
"vuln_id": "22713757-636a-415c-a9f8-1e09f2e071fc"
},
{
"attachments": [
{
"attachment_id": "b9e19a4b-ca18-4322-8fcc-f8cc45b0310e",
"attachment_name": "sitemap.csv",
"created_at": "2020-12-07T20:01:23.509304Z",
"file_type": "text/plain",
"md5": "md5:7534a6027dfa163d99e12359bfbd033a",
"size": 290
}
],
"created_at": "2020-12-07T20:01:19Z",
"details": {
"input_name": null,
"input_type": null,
"output": "The scan has discovered 1 distinct URL.\n\nThe following is a breakdown of which URLs were audited:\n\n- 1 effectively audited\n\nFor URLs we received responses for, here is a distribution of the content type headers:\n\n- 1 text/html; charset=utf-8\n\nResponse times ranged between 0.156857s and 0.156857s.\n\nYou can access the complete list of URLs with the information collected by the scan as an attachment to this plugin.",
"payload": null,
"proof": null,
"request": null,
"response": null,
"selector": null,
"selector_url": null,
"signature": null
},
"is_page": false,
"plugin_id": 98009,
"scan_id": "0d94f5b4-f811-44cb-802a-7f1c600818c3",
"uri": "http://example.com/",
"vuln_id": "5dff45a8-efbb-4ec7-8f70-067ae81c87f2"
}
],
"pagination": {
"limit": 3,
"offset": 0,
"sort": [
{
"name": "created_at",
"order": "desc"
}
],
"total": 632
}
}
}
Workflow Library Example
List Scan Vulnerabilities with Tenable and Send Results Via Email