Updated on 2025-09-24 GMT+08:00

Querying Vulnerability Management Statistics

Function

This API is used to query vulnerability management statistics.

Calling Method

For details, see Calling APIs.

URI

GET /v5/{project_id}/vulnerability/statistics

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Tenant project ID

Table 2 Query Parameters

Parameter

Mandatory

Type

Description

enterprise_project_id

No

String

Enterprise user ID. To query all enterprise projects, set this parameter to all_granted_eps.

Request Parameters

Table 3 Request header parameters

Parameter

Mandatory

Type

Description

x-auth-token

Yes

String

User token. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is a token.

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

need_urgent_repair

Integer

Number of vulnerabilities that need to be fixed urgently

unrepair

Integer

Number of vulnerabilities not fixed

existed_vul_hosts

Integer

Number of servers with vulnerabilities

today_handle

Integer

Vulnerabilities handled today

all_handle

Integer

Total handled vulnerabilities

supported

Integer

Supported vulnerabilities

vul_library_update_time

Long

Vulnerability library updated

Example Requests

Query vulnerability statistics whose project_id is 2b31ed520xxxxxxebedb6e57xxxxxxxx.

GET https://{endpoint}/v5/2b31ed520xxxxxxebedb6e57xxxxxxxx/vulnerability/statistics

Example Responses

Status code: 200

{
  "need_urgent_repair" : 22,
  "unrepair" : 23,
  "existed_vul_hosts" : 33,
  "today_handle" : 77,
  "all_handle" : 44,
  "supported" : 78,
  "vul_library_update_time" : 1692170925188
}

Status Codes

Status Code

Description

200

Error Codes

See Error Codes.