Query Parameters

These are the parameters for the Get Vulnerabilities v3 request.

When you use optional parameters to filter a list, there is an implicit AND between them: only entries that satisfy all of the criteria are retrieved.

Get Vulnerabilities filters vulnerability reports according to the criteria you specify. While these parameters are optional, you must specify at least one of them. The various ID values filter different categories of vulnerability; you can use the state parameters such as createdBefore and createdAfter to narrow your search.

Parameter	Required?	Description	Valid Values
vulnerabilityId
	no	The ID of a particular vulnerability	This has the format VULNERABILITY_*XXXXXXXXX*.
customerId	no	The ID of a particular customer	This has the form CUST_*XXXXXXXXX*.
scanId	no	The ID of a particular scan	This has the form TEST_*XXXXXXXXX*.
targetId	no	The ID of a particular target	This has the form TARGET_*XXXXXXXXX*.
targetGroupId
	no	The ID of a particular target group	This has the form TGRP_*XXXXXXXXX*.
createdBefore
	no	Retrieves only vulnerabilities found before this date.	This has the form *YYYY*-*MM*-*DD*.
createdAfter
	no	Retrieves only vulnerabilities found after this date.	This has the form *YYYY*-*MM*-*DD*.
serviceType	no	Retrieves vulnerabilities found by a particular type of test.	For example, "DAST Standard (DAST-S) (TEST)".
status	no	Retrieves only vulnerabilities that have a particular status.	Can equal "Open", "Closed", or "FalsePositive".
state	no	Retrieves only vulnerabilities that have a particular state.	Can equal either "OLD" or "NEW.

Parent topic:Get Vulnerabilities v3