List assets
GET {{baseUrl}}/workbenches/assets?date_range=67454373&filter.0.filter=?filter.0.filter=plugin.name&filter.0.quality=%26filter.0.quality=match&filter.0.value=%26filter.0.value=RHEL&filter.search_type=and&all_fields=deserunt
Retrieves a list of assets. The list can be modified using filters. The list returned is limited to 5,000. To retrieve more than 5,000 assets, use the export-request API.
Note: This endpoint is not intended for large or frequent exports of vulnerability or assets data. If you experience errors, reduce the volume, rate, or concurrency of your requests or narrow your filters. Contact support if you continue to experience errors. Additionally, Tenable recommends the POST /vulns/export endpoint for large or frequent exports of vulnerability data, and the POST /assets/export endpoint for large or frequent exports of assets data.
For information and best practices for retrieving vulnerability and assets data from Tenable.io, see Retrieve Vulnerability Data from Tenable.io and Retrieve Asset Data from Tenable.io.
Requires BASIC [16] user permissions. See Permissions.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
date_range | number | The number of days of data prior to and including today that should be returned. | |
filter.0.filter | string | The name of the filter to apply to the exported scan report. You can find available filters by using the GET /filters/workbenches/assets endpoint. If you specify the name of the filter, you must specify the operator as the filter.0.quality parameter and the value as the filter.0.value parameter. To use multiple filters, increment the <INDEX> portion of filter.<INDEX>.filter , for example, filter.0.filter . For more information about the format of this parameter, see Workbench Filters. | |
filter.0.quality | string | The operator of the filter to apply to the exported scan report. You can find the operators for the filter using the GET /filters/workbenches/assets endpoint. For more information about the format of this parameter, see Workbench Filters. | |
filter.0.value | string | The value of the filter to apply to the exported scan report. You can find valid values for the filter in the 'control' attribute of the objects returned by the GET /filters/workbenches/assets endpoint. For more information about the format of this parameter, see Workbench Filters. | |
filter.search_type | string | For multiple filters, specifies whether to use the AND or the OR logical operator. The default is AND. For more information about this parameter, see Workbench Filters. | |
all_fields | string | A value specifying whether you want the returned data to include all fields (full ) or only the default fields (default ). The schema for this endpoint defines the default fields only. For a definition of the full fields, see Common Asset Attributes. |
RESPONSES
status: OK
{"assets":[{"id":"31e37f64-cf0f-4ba0-9359-f5094a92352b","has_agent":false,"last_seen":"2018-12-31T17:28:28.000Z","last_scan_target":"172.204.81.57","sources":[{"name":"NESSUS_SCAN","first_seen":"2018-12-31T15:00:25.000Z","last_seen":"2018-12-31T17:28:28.000Z"}],"ipv4":["172.204.81.57"],"ipv6":[],"fqdn":[],"netbios_name":["S11C"],"operating_system":["Microsoft Windows Server 2008 R2 Datacenter Service Pack 1"],"agent_name":[],"aws_ec2_name":[],"mac_address":[],"bigfix_asset_id":[]},{"id":"7e35af00-a3f0-4d43-a354-0638ba2b05ae","has_agent":false,"last_seen":"2018-12-31T17:28:28.000Z","last_scan_target":"172.204.81.58","sources":[{"name":"NESSUS_SCAN","first_seen":"2018-12-31T15:00:25.000Z","last_seen":"2018-12-31T17:28:28.000Z"}],"acr_score":8,"acr_drivers":[{"driver_name":"device_type","driver_value":["general_purpose"]},{"driver_name":"device_capability","driver_value":["pci"]},{"driver_name":"internet_exposure","driver_value":["internal"]}],"exposure_score":753,"scan_frequency":[{"interval":90,"frequency":3,"licensed":false},{"interval":30,"frequency":1,"licensed":false},{"interval":60,"frequency":1,"licensed":false}],"ipv4":["172.204.81.58"],"ipv6":[],"fqdn":["freebsd11.dc.demo.io"],"netbios_name":[],"operating_system":["FreeBSD 11.1"],"agent_name":[],"aws_ec2_name":[],"mac_address":[],"bigfix_asset_id":[]},{"id":"466934be-abb4-4fa9-b8b8-27ace85e5523","has_agent":false,"last_seen":"2018-12-31T17:28:28.000Z","last_scan_target":"172.204.81.59","sources":[{"name":"NESSUS_SCAN","first_seen":"2018-12-31T15:00:25.000Z","last_seen":"2018-12-31T17:28:28.000Z"}],"ipv4":["172.204.81.59"],"ipv6":[],"fqdn":["fedorawork27.dc.demo.io"],"netbios_name":[],"operating_system":["Linux Kernel 4.13.9-300.fc27.x86_64 on Fedora release 27 (Twenty Seven)"],"agent_name":[],"aws_ec2_name":[],"mac_address":[],"bigfix_asset_id":[]}],"total":3}