Get Event History for Application - API

/rest/{version}/history/teams/{teamId}/applications/{appId}/history/objects

Descriptor	Value
HTTP Method	POST
Description	Lists event history for a given application.
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 POST Data Parameters

Parameter

Value

Required

Description

page

Integer

No

Number of events to return. By default this method will return up to 10 events.

numberToShow

Integer

No*

Can be used to return a different page of events, with each page of events containing {numberToShow}

events.

* If not specified, the default limit is 20

Sample Call:

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

Sample Output:

{
    "message": "",
    "success": true,
    "responseCode": -1,
    "object": {
        "retrievedHistory": true,
        "totalEventHistoryCount": 3,
        "eventHistory": [
            {
                "date": 1597998466000,
                "userName": "shagar(LOCAL)",
                "description": {
                    "string": "shagar(LOCAL) uploaded a Scan to Application. <span class='detail'>Checkmarx Scan dated May 14, 2015 4:33:00 AM with 267 Vulnerabilities. The scan was uploaded from Threadfix-web-community-7.1.3.4.xml.Pending Scan: 12</span>",
                    "urlCount": 0
                },
                "fileName": null,
                "action": "APPLICATION_SCAN_UPLOADED"
            },
            {
                "date": 1597998442000,
                "userName": "shagar (LOCAL)",
                "description": {
                    "string": "shagar (LOCAL) uploaded a scan to be processed  for Application. <span class='detail'>Pending Scan: 12</span>",
                    "urlCount": 0
                },
                "fileName": null,
                "action": "APPLICATION_SCAN_NEEDS_PROCESSING"
            },
            {
                "date": 1597997113000,
                "userName": "shagar (LOCAL)",
                "description": {
                    "string": "shagar (LOCAL) created Application.",
                    "urlCount": 0
                },
                "fileName": null,
                "action": "APPLICATION_CREATE"
            }
        ]
    }
}