Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Tenable Inventory API

The Tenable Inventory API enables users to search for their organization's assets and the software installed on those assets. Additionally, API endpoints are provided to retrieve a list of asset and software properties that can be used as filters on endpoints that support them. For more information, see [Inventory](https://docs.tenable.com/exposure-management/Content/exposure-management/inventory/inventory.htm) in the _Tenable Exposure Management User Guide_.

Tenable Inventory API is one of 107 APIs that Tenable publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Inventory. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 6 operations across 6 paths, and defines 15 schemas. It is described by OpenAPI 3.0.0, at version 1.0.0.

Requests are made against a single base URL, https://www.tenable.com/downloads/api/v2.

6 operations 6 paths 15 schemas 3 GET3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0.0
Base URL
https://cloud.tenable.com
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Tenable Inventory API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (Bearer). By default, every request must be authenticated.

  • Bearer — Example: Bearer {{token}}

Paths & Operations 6

Across 6 paths, the API surfaces 6 operations — 3 GET, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Inventory 6

The Tenable Inventory API enables users to search for their organization's assets and the software installed on those assets. Additionally, API endpoints are provided to retrieve…

POST
/api/v1/t1/inventory/assets/search
Search assets
inventory-assets-search 4 params body → 200400401403429500
POST
/api/v1/t1/inventory/findings/search
Search findings
inventory-findings-search 4 params body → 200400401403429500
POST
/api/v1/t1/inventory/software/search
Search software
inventory-software-search 4 params body → 200400401403429500
GET
/api/v1/t1/inventory/assets/properties
List asset properties
inventory-asset-properties-list 1 param → 200400401403429500
GET
/api/v1/t1/inventory/findings/properties
List finding properties
inventory-finding-properties-list → 200400401403429500
GET
/api/v1/t1/inventory/software/properties
List software properties
inventory-software-properties-list → 200400401403429500

Schemas 15

The contract defines 15 schemas that model the data the API accepts and returns. The most detailed are Inventory_Properties-Object (7 properties), Inventory_Response-Search-Assets-Object (6 properties), Inventory_Response-Search-Findings-Object (6 properties), Inventory_Response-Search-Software-Object (5 properties). Each schema is shown below with its type and property counts.

Inventory_Request-Search-Assets
object
An object containing a query and/or filters for a Tenable Exposure Management asset search.
2 properties
Inventory_ErrorResponse-400
object
2 properties
Inventory_Response-Search-Software
object
The software search results.
2 properties
Inventory_Response-Search-Findings
object
The findings search results.
2 properties
Inventory_Request-Search-Findings
object
An object containing a query and/or filters for a Tenable Exposure Management finding search.
2 properties
Inventory_Public-Sort-Object
object
An object specifying how the current result set is sorted, including the property by which the results were sorted and the sort direction.
2 properties
Inventory_Response-Search-Assets
object
The asset search results.
2 properties
Inventory_ErrorResponse
object
3 properties
Inventory_Request-Search-Software
object
An object containing a query and/or filters to search for installed software on your assets.
2 properties
Inventory_Properties-Object
object
7 properties
Inventory_Control
object
4 properties
Inventory_Response-Search-Findings-Object
object
6 properties
Inventory_Response-Search-Software-Object
object
5 properties
Inventory_Response-Search-Assets-Object
object
6 properties 4 required
Inventory_AssetClasses
string

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tenable-inventory-api-openapi.yml Raw ↑

Other APIs Tenable publishes across the network.

Tenable About API
Tenable Access Control (API) API
Tenable Access Control (Groups) API
Tenable Access Control (Permissions) API
Tenable Access Control (Roles) API
Tenable Access Control (Users) API
Tenable Access Groups v1 API
Tenable Access Groups v2 API
Tenable Account Groups API
Tenable Accounts API
Tenable Activity Log API
Tenable AD object API