List tag values

Returns a list of tag values.

Note: The list can also include the tag categories that do not have any associated values.

Requires the Basic [16] user role. See Roles.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

A filter condition in the field:operator:value format, for example, f=value:match:rhel. Filters should match field:op:value format. Filter conditions can include:

  • value:eq:<value>
  • value:match:<value>
  • category_name:match:<partial_value>
  • category_name:eq:<category_name>
  • category_name:match:<partial_category_name>
  • description:eq:<description>
  • description:match:<partial_description>
  • updated_at:date-eq:<timestamp_as_int>
  • updated_at:date-gt:<timestamp_as_int>
  • updated_at:date-lt:<timestamp_as_int>
  • updated_by:eq:<user_uuid>
string

If multiple f parameters are present, specifies whether Tenable Vulnerability Management applies AND or OR to conditions. Supported values are and and or. If you omit this parameter when using multiple f parameters, Tenable Vulnerability Management applies AND by default.

string

A comma-separated list of fields to include in the wildcard search. Provides the same functionality as a match condition in the f in parameter. For example, f=value:match:Chi returns the same results as wf=value&w=Chi. Wildcard fields include:

  • category_name
  • value
  • description
    Use the w parameter to specify the search value.
string

A single search value for the wildcard fields specified in the wf parameter.

int32
Defaults to 5000

The number of records to retrieve. If this parameter is omitted, Tenable Vulnerability Management uses the default value of 5000.

int32
Defaults to 0

The starting record to retrieve. If this parameter is omitted, Tenable Vulnerability Management uses the default value of 0.

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, value:desc would sort results by the value field in descending order.

If you specify multiple fields, the fields must be separated by commas. For example, value:desc,updated_at:asc would first sort results by the value field in descending order and then by the updated_at field in ascending order.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/html