Improved

Vulnerability Management: Pagination Support for List Exclusions

Tenable has added new query parameters to the List exclusions endpoint to support pagination and sorting of exclusion records. These parameters enable you to control the number of results returned, paginate through large result sets, and sort exclusions by supported properties.

This enhancement enables you to:

  • Limit the number of exclusions returned in a single request
  • Retrieve exclusion records using offset-based pagination
  • Sort exclusion results by name, type, or last modification date

The following query parameters are now supported:

Query ParameterData TypeDescription
limitIntegerSpecifies the maximum number of exclusions to return in the response. If omitted, the default value is 200. The maximum allowed value is 500.
offsetIntegerSpecifies the number of records to skip for offset-based pagination. If omitted, the default value is 0.
sortStringSpecifies the property and direction used to sort the results. The format is <property>:<direction>. Supported properties include name, type, and last_modification_date.

This update affects the following endpoint:

API EndpointNameUpdate
GET /exclusionsList exclusionsAdded support for the limit, offset, and sort query parameters.

Example: Paginate and sort exclusions

For example, to return 100 exclusions sorted by most recently modified, you could use the following cURL request:

curl --request GET \
     --url 'https://cloud.tenable.com/exclusions?limit=100&offset=0&sort=last_modification_date:desc' \
     --header 'X-ApiKeys: accessKey=<YOURKEY>;secretKey=<YOURKEY>' \
     --header 'accept: application/json'