Cisco PSIRT openVuln API Current Endpoints API

openapi: 3.2.0
info:
  version: 2.0.2
  title: Cisco PSIRT openVuln Current Endpoints API
  description: 'The Cisco Product Security Incident Response Team (PSIRT) openVuln API is a RESTful API that allows customers to obtain Cisco Security Vulnerability information in different machine-consumable formats. APIs are important for customers because they allow their technical staff and programmers to build tools that help them do their job more effectively (in this case, to keep up with security vulnerability information).

    For more information about the Cisco PSIRT openVuln API visit https://developer.cisco.com/psirt/

    For detail steps on how to use the API go to: https://developer.cisco.com/docs/psirt/

    '
  termsOfService: https://github.com/CiscoPSIRT/openVulnAPI/blob/master/LICENSE.md
  contact:
    name: Cisco PSIRT
    url: https://tools.cisco.com/security/center/publicationListing.x
    email: openvuln@cisco.com
  x-provenance:
    method: harvested
    authored_by: Cisco PSIRT
    harvested_by: API Evangelist
    harvested_on: '2026-08-19'
    first_party: true
    note: Published by Cisco. Retrieved unmodified except for this x-provenance block.
    provider_published: true
  x-evidence:
  - type: source
    url: https://github.com/CiscoPSIRT/openVulnAPI/blob/master/swagger/openVulnAPIOAS_3_0_3.yaml
  - type: raw
    url: https://raw.githubusercontent.com/CiscoPSIRT/openVulnAPI/master/swagger/openVulnAPIOAS_3_0_3.yaml
servers:
- url: https://api.cisco.com/{basePath}
  description: OpenVuln API - Applications created prior March 1, 2023; expires Sep 30, 2023
  variables:
    basePath:
      default: security/advisories/v2
      enum:
      - security/advisories
      - security/advisories/v2
- url: https://apix.cisco.com/{basePath}
  description: OpenVuln API - Applications created post March 1, 2023
  variables:
    basePath:
      default: security/advisories/v2
      enum:
      - security/advisories
      - security/advisories/v2
security:
- psirt_openvuln_api_auth: []
tags:
- name: Current Endpoints
  description: Current supported API endpoints.
paths:
  /all:
    get:
      description: Used to obtain information about all published security advisories.
      tags:
      - Current Endpoints
      parameters:
      - name: summaryDetails
        in: query
        description: Include the Advisory Summary Description or not
        required: false
        schema:
          type: boolean
      - name: productNames
        in: query
        description: Include the ProductNames or not
        required: false
        schema:
          type: boolean
      - name: pageIndex
        in: query
        description: The pageIndex field is an integer representing the current page index out of total number of pages
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
      - name: pageSize
        in: query
        description: The pageSize field is an integer representing the maximum number of items requested by the client for the current page. The maximum pageSize limit is 100.
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
      security:
      - psirt_openvuln_api_auth:
        - read:advisories
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Advisories'
            application/xml:
              schema:
                $ref: '#/components/schemas/Advisories'
        '404':
          description: Invalid extension used.  Currently this incorrect. In a minor update this will be moved to a 406 with the correct error message.
        '406':
          description: Invalid page index or size used
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorCode_INVALID_PAGEINDEX'
            application/xml:
              schema:
                $ref: '#/components/schemas/errorCode_INVALID_PAGEINDEX'
  /all/firstpublished:
    get:
      description: Used to obtain information about all published security advisories first published within a date timeframe.
      tags:
      - Current Endpoints
      parameters:
      - name: summaryDetails
        in: query
        description: Include the Advisory Summary Description or not
        required: false
        schema:
          type: boolean
      - name: productNames
        in: query
        description: Include the ProductNames or not
        required: false
        schema:
          type: boolean
      - name: startDate
        description: Format example Year-Month-Day 2022-05-12
        in: query
        required: true
        schema:
          type: string
          format: string
          pattern: ^\d{4}\-(0[1-9]|1[012])\-(0[1-9]|[12][0-9]|3[01])$
      - name: endDate
        in: query
        description: Format example Year-Month-Day 2022-05-12
        required: true
        schema:
          type: string
          format: string
          pattern: ^\d{4}\-(0[1-9]|1[012])\-(0[1-9]|[12][0-9]|3[01])$
      - name: pageIndex
        in: query
        description: The pageIndex field is an integer representing the current page index out of total number of pages
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
      - name: pageSize
        in: query
        description: The pageSize field is an integer representing the maximum number of items requested by the client for the current page. The maximum pageSize limit is 100.
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Advisories'
            application/xml:
              schema:
                $ref: '#/components/schemas/Advisories'
        '404':
          description: No advisories published within the date range supplied.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorCode_NO_DATA_FOUND'
            application/xml:
              schema:
                $ref: '#/components/schemas/errorCode_NO_DATA_FOUND'
        '406':
          description: Invalid page index or size used
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/errorCode_INVALID_PAGEINDEX'
                - $ref: '#/components/schemas/errorCode_MIN_PAGESIZE'
                - $ref: '#/components/schemas/errorCode_INVALID_DATE_FORMAT'
                - $ref: '#/components/schemas/errorCode_START_DATE_GREATER'
                - $ref: '#/components/schemas/errorCode_START_DATE_AND_END_DATE_MANDATORY'
            application/xml:
              schema:
                oneOf:
                - $ref: '#/components/schemas/errorCode_INVALID_PAGEINDEX'
                - $ref: '#/components/schemas/errorCode_MIN_PAGESIZE'
                - $ref: '#/components/schemas/errorCode_INVALID_DATE_FORMAT'
                - $ref: '#/components/schemas/errorCode_START_DATE_GREATER'
                - $ref: '#/components/schemas/errorCode_START_DATE_AND_END_DATE_MANDATORY'
  /all/lastpublished:
    get:
      description: Used to obtain information about all published security advisories last published within a date timeframe.
      tags:
      - Current Endpoints
      parameters:
      - name: summaryDetails
        in: query
        description: Include the Advisory Summary Description or not
        required: false
        schema:
          type: boolean
      - name: productNames
        in: query
        description: Include the ProductNames or not
        required: false
        schema:
          type: boolean
      - name: startDate
        in: query
        description: Format example Year-Month-Day 2022-05-12
        required: true
        schema:
          type: string
          format: string
          pattern: ^\d{4}\-(0[1-9]|1[012])\-(0[1-9]|[12][0-9]|3[01])$
      - name: endDate
        in: query
        description: Format example Year-Month-Day 2022-05-12
        required: true
        schema:
          type: string
          format: string
          pattern: ^\d{4}\-(0[1-9]|1[012])\-(0[1-9]|[12][0-9]|3[01])$
      - name: pageIndex
        in: query
        description: The pageIndex field is an integer representing the current page index out of total number of pages
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
      - name: pageSize
        in: query
        description: The pageSize field is an integer representing the maximum number of items requested by the client for the current page. The maximum pageSize limit is 100.
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Advisories'
            application/xml:
              schema:
                $ref: '#/components/schemas/Advisories'
        '404':
          description: No advisories published within the date range supplied.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorCode_NO_DATA_FOUND'
            application/xml:
              schema:
                $ref: '#/components/schemas/errorCode_NO_DATA_FOUND'
        '406':
          description: Invalid page index or size used
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/errorCode_INVALID_PAGEINDEX'
                - $ref: '#/components/schemas/errorCode_MIN_PAGESIZE'
                - $ref: '#/components/schemas/errorCode_INVALID_DATE_FORMAT'
                - $ref: '#/components/schemas/errorCode_START_DATE_GREATER'
                - $ref: '#/components/schemas/errorCode_START_DATE_AND_END_DATE_MANDATORY'
            application/xml:
              schema:
                oneOf:
                - $ref: '#/components/schemas/errorCode_INVALID_PAGEINDEX'
                - $ref: '#/components/schemas/errorCode_MIN_PAGESIZE'
                - $ref: '#/components/schemas/errorCode_INVALID_DATE_FORMAT'
                - $ref: '#/components/schemas/errorCode_START_DATE_GREATER'
                - $ref: '#/components/schemas/errorCode_START_DATE_AND_END_DATE_MANDATORY'
  /advisory/{advisoryId}:
    get:
      description: Used to obtain an advisory given its advisory ID `advisoryId` (i.e., cisco-sa-20180221-ucdm)
      tags:
      - Current Endpoints
      parameters:
      - name: advisoryId
        in: path
        description: Enter advisory ID.  Defaults to .json format, use advisoryId.xml if require xml format.
        required: true
        schema:
          type: string
          format: cisco-sa-XXX
          example: cisco-sa-20180221-ucdm
      - name: summaryDetails
        in: query
        description: Include the Advisory Summary Description or not
        required: false
        schema:
          type: boolean
      - name: productNames
        in: query
        description: Include the ProductNames or not
        required: false
        schema:
          type: boolean
      security:
      - psirt_openvuln_api_auth:
        - read:advisories
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Advisories'
            application/xml:
              schema:
                $ref: '#/components/schemas/Advisories'
        '404':
          description: Invalid advisory id used or not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorCode_ADVISORYID_NOT_FOUND'
            application/xml:
              schema:
                $ref: '#/components/schemas/errorCode_ADVISORYID_NOT_FOUND'
        '406':
          description: Invalid extension used
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorCode_INVALID_EXTENSION'
            application/xml:
              schema:
                $ref: '#/components/schemas/errorCode_INVALID_EXTENSION'
  /cve/{cve_id}:
    get:
      description: Used to obtain an advisory using a given Common Vulnerability Enumerator (CVE). The `cve_id` format is CVE-YYYY-NNNN. For more information about CVE visit http://cve.mitre.org/
      tags:
      - Current Endpoints
      parameters:
      - name: cve_id
        in: path
        description: CVE Identifier (i.e., CVE-YYYY-NNNN)
        required: true
        schema:
          type: string
          format: CVE-YYYY-NNNN
      - name: summaryDetails
        in: query
        description: Include the Advisory Summary Description or not
        required: false
        schema:
          type: boolean
      - name: productNames
        in: query
        description: Include the ProductNames or not
        required: false
        schema:
          type: boolean
      security:
      - psirt_openvuln_api_auth:
        - read:advisories
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Advisories'
            application/xml:
              schema:
                $ref: '#/components/schemas/Advisories'
        '404':
          description: Invalid or not found CVE-ID.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorCode_NO_DATA_FOUND_CVE'
            application/xml:
              schema:
                $ref: '#/components/schemas/errorCode_NO_DATA_FOUND_CVE'
  /bugid/{bug_id}:
    get:
      description: Used to obtain an advisory using a given bug_id . The `bug_id` format is start with CSC.
      tags:
      - Current Endpoints
      parameters:
      - in: path
        name: bug_id
        description: BUG Identifier (i.e., CSCxyNNNNN)
        required: true
        schema:
          type: string
          format: CSCxyNNNNN
      - in: query
        name: summaryDetails
        description: Include the Advisory Summary Description or not
        required: false
        schema:
          type: boolean
      - in: query
        name: productNames
        description: Include the ProductNames or not
        required: false
        schema:
          type: boolean
      security:
      - psirt_openvuln_api_auth:
        - read:advisories
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Advisories'
            application/xml:
              schema:
                $ref: '#/components/schemas/Advisories'
        '404':
          description: No advisories with supplied Cisco Bug ID found.  Currently this returns a partial match on the bug id; not an exact match.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorCode_NO_DATA_FOUND'
            application/xml:
              schema:
                $ref: '#/components/schemas/errorCode_NO_DATA_FOUND'
  /latest/{number}:
    get:
      description: Used to obtain all the latest security advisories given an absolute number. For instance, the latest 10 or latest 5.
      tags:
      - Current Endpoints
      parameters:
      - name: number
        in: path
        description: An absolute number to obtain the latest security advisories.
        required: true
        schema:
          type: integer
          format: number
      - name: summaryDetails
        in: query
        description: Include the Advisory Summary Description or not
        required: false
        schema:
          type: boolean
      - name: productNames
        in: query
        description: Include the ProductNames or not
        required: false
        schema:
          type: boolean
      security:
      - psirt_openvuln_api_auth:
        - read:advisories
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Advisories'
            application/xml:
              schema:
                $ref: '#/components/schemas/Advisories'
        '406':
          description: Invalid advisory count used.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorCode_INVALID_ADV_COUNT'
            application/xml:
              schema:
                $ref: '#/components/schemas/errorCode_INVALID_ADV_COUNT'
  /severity/{severity}:
    get:
      description: Used to obtain all security advisories for a given security impact rating (critical, high, medium, low or informational)
      tags:
      - Current Endpoints
      parameters:
      - name: severity
        in: path
        description: Critical, High, Medium, Low or informational
        required: true
        schema:
          type: string
          enum:
          - critical
          - high
          - medium
          - low
          - informational
      - name: summaryDetails
        in: query
        description: Include the Advisory Summary Description or not
        required: false
        schema:
          type: boolean
      - name: productNames
        in: query
        description: Include the ProductNames or not
        required: false
        schema:
          type: boolean
      - name: pageIndex
        in: query
        description: The pageIndex field is an integer representing the current page index out of total number of pages
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
      - name: pageSize
        in: query
        description: The pageSize field is an integer representing the maximum number of items requested by the client for the current page. The maximum pageSize limit is 100.
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
      security:
      - psirt_openvuln_api_auth:
        - read:advisories
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Advisories'
            application/xml:
              schema:
                $ref: '#/components/schemas/Advisories'
        '404':
          description: No advisories by a given severity are found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorCode_NO_DATA_FOUND'
            application/xml:
              schema:
                $ref: '#/components/schemas/errorCode_NO_DATA_FOUND'
        '406':
          description: Invalid query parameters
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/errorCode_INVALID_PAGEINDEX_LONG'
                - $ref: '#/components/schemas/errorCode_MIN_PAGESIZE'
                - $ref: '#/components/schemas/errorCode_INVALID_SEVERITY'
                - $ref: '#/components/schemas/errorCode_START_DATE_GREATER'
                - $ref: '#/components/schemas/errorCode_START_DATE_AND_END_DATE_MANDATORY'
            application/xml:
              schema:
                oneOf:
                - $ref: '#/components/schemas/errorCode_INVALID_PAGEINDEX_LONG'
                - $ref: '#/components/schemas/errorCode_MIN_PAGESIZE'
                - $ref: '#/components/schemas/errorCode_INVALID_SEVERITY'
                - $ref: '#/components/schemas/errorCode_START_DATE_GREATER'
                - $ref: '#/components/schemas/errorCode_START_DATE_AND_END_DATE_MANDATORY'
  /severity/{severity}/firstpublished:
    get:
      description: Used to obtain all security advisories for a given security impact rating (critical, high, medium, low or informational) and additionally filter based of firstpublished start date and enddate.
      tags:
      - Current Endpoints
      parameters:
      - name: severity
        in: path
        description: Used to obtain all advisories that have a specific security impact rating
        required: true
        schema:
          type: string
          enum:
          - critical
          - high
          - medium
          - low
          - informational
      - name: startDate
        in: query
        description: Format example Year-Month-Day 2022-05-12
        required: true
        schema:
          type: string
          format: string
          pattern: ^\d{4}\-(0[1-9]|1[012])\-(0[1-9]|[12][0-9]|3[01])$
      - name: endDate
        in: query
        required: true
        schema:
          type: string
          format: string
          pattern: ^\d{4}\-(0[1-9]|1[012])\-(0[1-9]|[12][0-9]|3[01])$
      - name: summaryDetails
        in: query
        description: Include the Advisory Summary Description or not
        required: false
        schema:
          type: boolean
      - name: productNames
        in: query
        description: Include the ProductNames or not
        required: false
        schema:
          type: boolean
      - name: pageIndex
        in: query
        description: The pageIndex field is an integer representing the current page index out of total number of pages
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
      - name: pageSize
        in: query
        description: The pageSize field is an integer representing the maximum number of items requested by the client for the current page. The maximum pageSize limit is 100.
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
      security:
      - psirt_openvuln_api_auth:
        - read:advisories
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Advisories'
            application/xml:
              schema:
                $ref: '#/components/schemas/Advisories'
        '404':
          description: No advisories by a given severity are found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorCode_NO_DATA_FOUND'
            application/xml:
              schema:
                $ref: '#/components/schemas/errorCode_NO_DATA_FOUND'
        '406':
          description: Invalid query parameters
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/errorCode_INVALID_PAGEINDEX'
                - $ref: '#/components/schemas/errorCode_MIN_PAGESIZE'
                - $ref: '#/components/schemas/errorCode_INVALID_DATE_FORMAT'
                - $ref: '#/components/schemas/errorCode_INVALID_SEVERITY'
                - $ref: '#/components/schemas/errorCode_START_DATE_AND_END_DATE_MANDATORY'
            application/xml:
              schema:
                oneOf:
                - $ref: '#/components/schemas/errorCode_INVALID_PAGEINDEX'
                - $ref: '#/components/schemas/errorCode_MIN_PAGESIZE'
                - $ref: '#/components/schemas/errorCode_INVALID_DATE_FORMAT'
                - $ref: '#/components/schemas/errorCode_INVALID_SEVERITY'
                - $ref: '#/components/schemas/errorCode_START_DATE_AND_END_DATE_MANDATORY'
  /severity/{severity}/lastpublished:
    get:
      description: Used to obtain all security advisories for a given security impact rating (critical, high, medium, low or informational) and additionally filter based of lastpublished start date and enddate.
      tags:
      - Current Endpoints
      parameters:
      - name: severity
        in: path
        description: Used to obtain all advisories that have a specific security impact rating
        required: true
        schema:
          type: string
          enum:
          - critical
          - high
          - medium
          - low
          - informational
      - name: startDate
        in: query
        description: Format example Year-Month-Day 2022-05-12
        required: true
        schema:
          type: string
          format: string
          pattern: ^\d{4}\-(0[1-9]|1[012])\-(0[1-9]|[12][0-9]|3[01])$
      - name: endDate
        in: query
        description: Format example Year-Month-Day 2022-05-12
        required: true
        schema:
          type: string
          format: string
          pattern: ^\d{4}\-(0[1-9]|1[012])\-(0[1-9]|[12][0-9]|3[01])$
      - name: summaryDetails
        in: query
        description: Include the Advisory Summary Description or not
        required: false
        schema:
          type: boolean
      - name: productNames
        in: query
        description: Include the ProductNames or not
        required: false
        schema:
          type: boolean
      - name: pageIndex
        in: query
        description: The pageIndex field is an integer representing the current page index out of total number of pages
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
      - name: pageSize
        in: query
        description: The pageSize field is an integer representing the maximum number of items requested by the client for the current page. The maximum pageSize limit is 100.
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
      security:
      - psirt_openvuln_api_auth:
        - read:advisories
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Advisories'
            application/xml:
              schema:
                $ref: '#/components/schemas/Advisories'
        '404':
          description: No advisories by a given severity are found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorCode_NO_DATA_FOUND'
            application/xml:
              schema:
                $ref: '#/components/schemas/errorCode_NO_DATA_FOUND'
        '406':
          description: Invalid query parameters
          content:
            application/json:
              schema:
                oneOf:
                - $ref: '#/components/schemas/errorCode_INVALID_PAGEINDEX'
                - $ref: '#/components/schemas/errorCode_MIN_PAGESIZE'
                - $ref: '#/components/schemas/errorCode_INVALID_DATE_FORMAT'
                - $ref: '#/components/schemas/errorCode_INVALID_SEVERITY'
                - $ref: '#/components/schemas/errorCode_START_DATE_AND_END_DATE_MANDATORY'
            application/xml:
              schema:
                oneOf:
                - $ref: '#/components/schemas/errorCode_INVALID_PAGEINDEX'
                - $ref: '#/components/schemas/errorCode_MIN_PAGESIZE'
                - $ref: '#/components/schemas/errorCode_INVALID_DATE_FORMAT'
                - $ref: '#/components/schemas/errorCode_INVALID_SEVERITY'
                - $ref: '#/components/schemas/errorCode_START_DATE_AND_END_DATE_MANDATORY'
  /product:
    get:
      description: Used to obtain all the advisories that affects the given product name.
      tags:
      - Current Endpoints
      parameters:
      - name: product
        in: query
        description: An product name to obtain security advisories that matches given product name.
        required: true
        schema:
          type: string
          format: string
      - name: summaryDetails
        in: query
        description: Include the Advisory Summary Description or not
        required: false
        schema:
          type: boolean
      - name: productNames
        in: query
        description: Include the ProductNames or not
        required: false
        schema:
          type: boolean
      - name: pageIndex
        in: query
        description: The pageIndex field is an integer representing the current page index out of total number of pages
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
      - name: pageSize
        in: query
        description: The pageSize field is an integer representing the maximum number of items requested by the client for the current page. The maximum pageSize limit is 100.
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
      security:
      - psirt_openvuln_api_auth:
        - read:advisories
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Advisories'
            application/xml:
              schema:
                $ref: '#/components/schemas/Advisories'
        '404':
          description: No advisories found matching product name.  To check product names use https://tools.cisco.com/security/center/productBoxData.x?prodType=CISCO
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorCode_PRODUCT_NOT_FOUND'
            application/xml:
              schema:
                $ref: '#/components/schemas/errorCode_PRODUCT_NOT_FOUND'
        '406':
          description: Invalid page index or size used
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorCode_INVALID_PRODUCT_NAME_FORMAT'
            application/xml:
              schema:
                $ref: '#/components/schemas/errorCode_INVALID_PRODUCT_NAME_FORMAT'
  /year/{year}:
    get:
      description: Used to obtain all security advisories that have were originally published in a specific year `YYYY`.
      tags:
      - Current Endpoints
      parameters:
      - name: year
        in: path
        description: The four digit year.
        required: true
        schema:
          type: string
          format: YYYY
      - name: summaryDetails
        in: query
        description: Include the Advisory Summary Description or not
        required: false
        schema:
          type: boolean
      - name: productNames
        in: query
        description: Include the ProductNames or not
        required: false
        schema:
          type: boolean
      - name: pageIndex
        in: query
        description: The pageIndex field is an integer representing the current page index out of total number of pages
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
      - name: pageSize
        in: query
        description: The pageSize field is an integer representing the maximum number of items requested by the client for the current page. The maximum pageSize limit is 100.
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
      security:
      - psirt_openvuln_api_auth:
        - read:advisories
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Advisories'
            application/xml:
              schema:
                $ref: '#/components/schemas/Advisories'
        '404':
          description: No advisories are found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorCode_NO_DATA_FOUND'
            application/xml:
              schema:
                $ref: '#/components/schemas/errorCode_NO_DATA_FOUND'
        '406':
          description: Invalid year, page index or size used.  Year should be in range 1995 to current year
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorCode

# --- truncated at 32 KB (49 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/cisco-psirt/refs/heads/main/openapi/cisco-psirt-current-endpoints-api-openapi.yml