List remediation scans

get

https://cloud.tenable.com/scans/remediation

Returns a list of remediation scans where you have at least CAN VIEW [16] scan permissions.

Note: Keep in mind potential rate limits when using this endpoint. To check the status of your scans, use the GET /scans/{scan_id}/latest-status endpoint. Tenable recommends the GET /scans/{scan_id}/latest-status endpoint especially if you are programmatically checking the status of large numbers of scans.

Requires the Basic [16] user role and the Can View [16] scan permission. Alternatively, requires the VM.VM_REMEDIATION.VM_REMEDIATION.READ custom role privilege. See Roles and Permissions.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

limit

integer

The number of records to retrieve. Minimum value is 1. Maximum value is 200. If this parameter is omitted, Tenable Vulnerability Management uses the default value of 50.

offset

integer

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

sort

string

enum

The field you want to sort the results by along with the sort order. Valid sort fields: scan_creation_date. Valid sort orders: desc, asc. scan_creation_date is the Unix timestamp when the remediation scan run was created. If this parameter is omitted, Tenable Vulnerability Management uses the default value of scan_creation_date:desc.

Allowed:

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

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 remediation scan list is retrieved successfully.

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