Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

/rest/{version}/applications/{appId}


Descriptor

Value

HTTP Method

GET

Description

Retrieves an application using the given appId.

Required Permission

Read Access (Any Role)

Version Introduced2.3.0

Changes in 2.4.0                

Added new “tags” and “versions” sections to response.

Changes in 2.5.0.2Added new "filterSet" field to response.
Changes in 2.5.1Added the "updatedDate" field to the response.  This field is present when using older REST versions as well.
Changes in 2.7.5Added the Application Metadata to the response.  Only if using v2.7.5 or later.


Request Header Parameters

Parameter

Value

Required

Description

Accept

String

Yes

A value of ‘application/json’ must be provided.


Sample Call:

Code Block
languagebash
themeEclipse
curl --insecure -H 'Accept: application/json' -H "Authorization: APIKEY {apiKey}" http://localhost:8080/threadfix/rest/v2.7.5/applications/54


Sample Output:


Code Block
themeEclipse
{
    "message": "",
    "success": true,
    "responseCode": -1,
    "object": {
        "id": 54,
        "name": "Test App",
        "url": "http://example.com",
        "uniqueId": null,
        "applicationCriticality": {
            "id": 1,
            "name": "Low"
        },
		"policyStatuses": [
            {
                "id": 1,
                "currentStatus": "FAILING",
                "policy": {
                    "name": "New Policy",
                    "filterName": "Default",
                    "id": 1
                }
            }
        ],
		"description": null,
        "releaseFrequency": "UNKNOWN",
        "testEnvironment": null,
        "grcApplication": null,
        "scans": [
            {
                "id": 383,
                "importTime": 1309962639000,
				"updatedDate": 1309962639000,
                "numberClosedVulnerabilities": 0,
                "numberNewVulnerabilities": 2,
                "numberOldVulnerabilities": 0,
                "numberResurfacedVulnerabilities": 0,
                "numberTotalVulnerabilities": 2,
                "numberRepeatResults": 0,
                "numberRepeatFindings": 0,
                "numberInfoVulnerabilities": 0,
                "numberLowVulnerabilities": 0,
                "numberMediumVulnerabilities": 1,
                "numberHighVulnerabilities": 1,
                "numberCriticalVulnerabilities": 0,
                "scannerName": "w3af"
				"numberUnassignedVulnerabilities": 0
            }
        ],
        "infoVulnCount": 0,
        "lowVulnCount": 0,
        "mediumVulnCount": 1,
        "highVulnCount": 1,
        "criticalVulnCount": 0,
        "totalVulnCount": 2,
		"isInternal": false,
        "tags": [
            {
                "id": 11,
                "name": "First Tag",
                "type": "APPLICATION"
            },
            {
                "id": 12,
                "name": "Second Tag",
                "type": "APPLICATION"
            }
        ],
        "versions": [
            {
                "id": 14,
                "name": "Version 1",
                "date": 1293861600000
            },
            {
                "id": 15,
                "name": "Version 2",
                "date": 1357020000000
            }
        ],
		"riskRating": "HIGH",
        "filterSet": "Developer View",
        "applicationMetadataList": [
            {
                "id": 4,
                "orderPosition": 1,
                "description": "12.4",
                "title": "Version"
            }
        ],
		"unassignedVulnCount": 0,
        "waf": null,
        "organization": {
            "name": "Test Team",
            "id": 22
        }
    }
}


Page Tree
rootApplications API