{"type":"api","title":"/cvrf/all/firstpublished","meta":{"id":"/apps/pubhub/media/psirt-docs/89eb7ed57114b0017dfd4232666ca8a01095e144/77abf0dd-caf5-31f5-9198-1d2476135141","info":{"version":"2.0.1","title":"Cisco PSIRT openVuln 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).\n","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"}},"security":[{"psirt_openvuln_api_auth":[]}],"tags":[{"name":"Current Endpoints","description":"Current supported API endpoints."},{"name":"Sunset Endpoints","description":"The \"security/advisories\" basepath will be deprecated in the future. These API endpoints have changed with the introduction of v2 basepath. Migrate the below endpoints to current endpoint calls. The below endpoints only work with \"security/advisories\" basepath."},{"name":"Obsolete Endpoints","description":"These API endpoints are no longer available. Migrate to current version calls."}],"openapi":"3.0.3","servers":[{"url":"https://apix.cisco.com/{basePath}","description":"OpenVuln API - Applications created post March 1, 2023","variables":{"basePath":{"default":"security/advisories/v2"}}},{"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"]}}}],"securitySchemes":{"psirt_openvuln_api_auth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}}},"spec":{"description":"Used to obtain information about all published security advisories first published within a date timeframe.","deprecated":true,"tags":["Obsolete 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}}],"security":[{"psirt_openvuln_api_auth":["read:advisories"]}],"responses":{"410":{"description":"Endpoint containing /cvrf/ is now obsolete.","content":{"application/json":{"schema":{"description":"And End of Life endpoint. Migrate your code to latest API endpoint.","properties":{"errorCode":{"type":"string","example":"URI_NOT_AVAILABLE"},"errorMessage":{"type":"string","example":"URI_CONTAINING(/CVRF/)_IS_NO_LONGER_AVAILABLE"}},"$$ref":"#/components/schemas/EndofLife"}},"application/xml":{"schema":{"description":"And End of Life endpoint. Migrate your code to latest API endpoint.","properties":{"errorCode":{"type":"string","example":"URI_NOT_AVAILABLE"},"errorMessage":{"type":"string","example":"URI_CONTAINING(/CVRF/)_IS_NO_LONGER_AVAILABLE"}},"$$ref":"#/components/schemas/EndofLife"}}}}},"method":"get","path":"/cvrf/all/firstpublished"}}