Get Event History for Vulnerability - API

/rest/{version}/history/vulnerabilities/{vulnId}/history/objects

Descriptor	Value
HTTP Method	POST
Description	Returns a list of history events for a given vulnerability.
Required Permission	Read Access
Version Introduced	2.8.3

Request Header Parameters

Parameter	Value	Required	Description
Accept	String	Yes	A value of ‘application/json’ must be provided.

Request Get Parameters

Parameter

Value Type

Required

Description

page

Integer

No

Which page of vulnerability history events to return.

numberToShow

Integer

No*

How many vulnerability history events to return.

* If not specified, the default limit is 20

Sample Calls:

curl -H 'Accept: application/json' -H 'Authorization: APIKEY {apiKey}' http://localhost:8083/threadfix/rest/latest/history/vulnerabilities/16484/history/objects?numberToShow=25&page=1

Sample Output:

{
    "message": "",
    "success": true,
    "responseCode": -1,
    "object": {
        "retrievedHistory": true,
        "eventHistory": [
            {
                "id": 110,
                "date": 1597997707000,
                "eventAction": "VULNERABILITY_OPEN_SCAN_UPLOAD",
                "detail": null,
                "status": null,
                "groupCount": null,
                "description": "ThreadFix performed an action: Create Vulnerability From Scan Upload",
                "userName": "ThreadFix",
                "vulnerabilityId": 68,
                "applicationId": 1,
                "organizationId": null,
                "defectId": null,
                "vulnerabilityDescriptionWithUrls": {
                    "string": "ThreadFix created Vulnerability uploading a <a href='{URL_0}'>Scan</a> to Application.",
                    "{URL_0}": "/organizations/3/applications/1/scans/11",
                    "urlCount": 1
                },
                "vulnerabilityCommentId": null,
                "eventActionDisplayName": "Create Vulnerability From Scan Upload",
                "scanId": 11
            }
        ]
    }
}