List exclusions

get

https://cloud.tenable.com/exclusions

Returns a list of exclusions for your Tenable Vulnerability Management scans. If the request includes none of the limit, offset, and sort parameters, the system returns all exclusions and omits the pagination object.

Requires the Scan Manager [40] user role or the VM.VM_SCAN.VM_SCAN_EXCLUSION.READ custom role privilege. See Roles.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

limit

integer

0 to 500

Specifies the maximum number of exclusions to return in the response. If the request includes offset or sort but not limit, or sets limit to 0, the system uses the default value of 200. If the request includes none of the limit, offset, and sort parameters, the system returns all exclusions. The maximum allowed value is 500.

offset

integer

≥ 0

Defaults to 0

Specifies the number of records to skip for offset-based pagination. If omitted, the system uses the default value of 0. The API does not enforce a maximum limit on the offset value.

sort

string

Specifies the property and direction used to sort the results. The format is <property>:<direction>. Supported properties:

name — The descriptive name of the exclusion.
type — The operational type of the exclusion, derived from the schedule.enabled property. If schedule.enabled is false, the type evaluates to Always On. If schedule.enabled is true, the type evaluates to Scheduled.
last_modification_date — The date and time the exclusion was last modified.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

403

Returned if you do not have permission to list exclusions.

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

text/html

200Returned if the list of exclusions was retrieved successfully.

401Returned if the API keys specified in your request are invalid.

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

500Returned if an internal error occurred.