Vulnerability Management: New Date Filters for List Scans

Tenable has added two new optional query parameters to the List scans endpoint to help you filter scan results by start time. These parameters enable you to retrieve scans that started within a specific time range, making it easier to query recent activity or list scans over a defined period. You can use these parameters individually or together to define an open-ended or bounded time range.

The following query parameters are now supported:

Query Parameter	Data Type	Description
`started_from`	Integer (Unix timestamp)	Filters results to scans started on or after the specified Unix timestamp (in seconds).
`started_to`	Integer (Unix timestamp)	Filters results to scans started on or before the specified Unix timestamp (in seconds).

This update affects the following endpoints:

API Endpoint	Name	Update
GET /scans	List scans	Returns a list of scans where you have at least CAN VIEW [16] scan permissions.

Example: Filter scans by a bounded time range

For example, to filter the list of scans by a bounded time range (between between Thu Feb 12, 2026 07:36:43 UTC and Fri Feb 13, 2026 07:36:40 UTC), you could use the following request:

curl --request GET \
     --url 'https://cloud.tenable.com/scans?started_from=1770881803&started_to=1770968200' \
     --header 'X-ApiKeys: accessKey=<YOURKEY>;secretKey=<YOURKEY>' \
     --header 'accept: application/json'