Retrieve All Advisories by Filter

The Cisco PSIRT OpenVuln API allows users to retrieve all advisories based on:

• All advisories without a filter

  The all query returns all Cisco published security advisories.

• All advisories within a date range (either via first published or last updated dates)

  The all query returns all Cisco published security advisories that were newly published within a given date range

• All advisories within a given year

  Used to obtain all advisories published in a given year.

• All advisories with a given Security Impact Rating (SIR) and/or with a given date range (either via first published or last updated dates)

  Used to obtain all security advisories with a given SIR .

• The last number of X Advisories

  Used to obtain the specified number of the latest advisories updated

The below section gives examples using CURL.

1. All advisories without a filter

Request

curl -X GET -H "Accept: application/json" -H "Authorization: Bearer <removed>" 'https://apix.cisco.com/security/advisories/v2/all'

2. All advisories within a date range (either via first published or last updated dates)

Request

This example shows retrieving all advisories that originally published between 1st January 2023 and 2nd February 2023.

curl -X GET -H "Accept: application/json" -H "Authorization: Bearer <removed>" 'https://apix.cisco.com/security/advisories/v2/all/firstpublished?startDate=2023-01-01&endDate=2023-02-02'

This example shows retrieving all advisories that updated and republished between 1st January 2023 and 2nd February 2023.

curl -X GET -H "Accept: application/json" -H "Authorization: Bearer <removed>" 'https://apix.cisco.com/security/advisories/v2/all/lastpublished?startDate=2023-01-01&endDate=2023-02-02'

3. All advisories within a given year

This example shows retrieving all advisories that were originally published in the year 2023.

Request

curl -X GET -H "Accept: application/json" -H "Authorization: Bearer <removed>" 'https://apix.cisco.com/security/advisories/v2/year/2023'

4. All advisories with a given Security Impact Rating (SIR) and/or with a given date range (either via first published or last updated dates)

This example shows retrieving all advisories that were originally published with a SIR of Critical.

Request

curl -X GET -H "Accept: application/json" -H "Authorization: Bearer <removed>" 'https://apix.cisco.com/security/advisories/v2/severity/Critical'

This example shows retrieving all advisories that were originally published with a SIR of Critical published after 1st January 2023.

curl -X GET -H "Accept: application/json" -H "Authorization: Bearer <removed>" 'https://apix.cisco.com/security/advisories/v2/severity/Critical/firstpublished?startDate=2023-01-01&endDate=2023-03-03'

5. The last number of X Advisories

This example shows retrieving the last 5 advisories that were published.

Request

curl -X GET -H "Accept: application/json" -H "Authorization: Bearer <removed>" 'https://apix.cisco.com/security/advisories/v2/latest/5'