TOC & Recently Viewed

Recently Viewed Topics

List Assets

User Permissions: Basic (16)

To list assets, use the API endpoint described below.

Note: lists only assets from access groups to which you belong. For more information, see access-groups in the API reference guide.

HTTP Request

Note: To authenticate your request, be sure to include API keys in the HTTP header of the request. For more information, see Authorization.

Request Path Syntax


Request Path Parameters


Request Path Example

See "Request Path Syntax."

HTTP Response

Response Codes

Status Description
200 Returns a list of assets. For more information, see "Response Body Syntax."
403 Returned if you do not have permission to list assets.

Returned if you attempt to send too many requests in a specific period of time. For more information, see Rate Limiting.

Response Body Syntax

{ "assets": [ { "id": {string}, "has_agent": {boolean}, "last_seen": {string}, "sources": [ { "name": {string}, "first_seen": {string}, "last_seen": {string} } ], "ipv4": [ {string}, {string} ], "ipv6": [ {string}, {string} ], "fqdn": [ {string}, {string} ], "netbios_name": [ {string}, {string} ], "operating_system": [ {string}, {string} ], "agent_name": [ {string}, {string} ], "aws_ec2_name": [ {string}, {string} ], "mac_address": [ {string}, {string} ] }, ], "total": {integer} } }

Response Body Attributes

Attribute Object Attribute Type Description
assets id string The UUID of the asset.
has_agent boolean

Specifies whether a Nessus agent scan identified the asset.

last_seen string

The time and date of the scan that most recently identified the asset.

sources array

The sources of the scans that identified the asset. For more information, see Source Objects.

ipv4 array A list of IPv4 addresses for the asset.
ipv6 array A list of IPv6 addresses for the asset.
fqdn array A list of FQDNs for the asset.
netbios_name string

The NetBIOS name for the asset.

operating_system string The operating system installed on the asset.
agent_name array

The names of any Nessus agents that scanned and identified the asset.

aws_ec2_name string

The name of the virtual machine instance in AWS EC2.

mac_address array A list of MAC addresses for the asset.
totals integer The total number of assets in the list.

Response Body Example

{ "assets": [ { "id": "ebe455fa-0558-4cd4-8b07-7164e27bcb81", "has_agent": false, "last_seen": "2018-08-30T13:46:31.449Z", "sources": [ { "name": "connector", "first_seen": "2018-08-30T13:39:51.176Z", "last_seen": "2018-08-30T13:46:31.449Z" } ], "ipv4": [ "", "" ], "ipv6": [], "fqdn": [], "netbios_name": [], "operating_system": [ "windows" ], "agent_name": [], "aws_ec2_name": [], "mac_address": [] }, ], "total": 102 } }

Reference Guide

Copyright © 2019 Tenable, Inc. All rights reserved. Tenable,, Tenable Network Security, Nessus, SecurityCenter, SecurityCenter Continuous View and Log Correlation Engine are registered trademarks of Tenable, Inc.., Lumin, Assure, and the Cyber Exposure Company are trademarks of Tenable, Inc. All other products or services are trademarks of their respective owners.