Appearance
Get scanners.
GET
/backend/v1/scanners
Retrieves a list of scanners that match the given criteria,
with the option to adjust the limit for more results.
Authorizations
HTTPBearer
TypeHTTP (bearer)
Parameters
Query Parameters
includePackages
Include the packages for scanners in the response.
Typeboolean
default
false
cursor
Selects page for paginated results. Pass in the next or prev attribute in the response
search
Only return results that match the given text.
limit
Limits the amount of results.
Typeinteger
default
10
maximum
100
minimum
1
ascending
Whether results should be sorted in ascending order.
Typeboolean
default
false
published
Get scanners that match the given published state
direction
Get results that scan in the given direction.
source
Get results that were created from the given source.
type
Get results that are of the given scan type.
packaged
Get results that are packaged or not.
sortBy
Sort results by the given parameter.
Typestring
Enum
name
updated_at
active
Get results that are active/inactive. Only has an effect if addedToProjectId or availableToProjectId is provided.
groupId
Get results created for the given group.
endpoint
Get results match the chosen active state for the given endpoint.
enabledForProject
Get results match the chosen active state for the given project.
tags
Get results with the given tags
addedToProjectId
Get scanners added to project
accessibleToProjectId
Get scanners accessible to project
mode
Get scanners that are set to given mode(s) for the chosen project.
Responses
Successful Response
application/json
JSON
{
"next": "string",
"prev": "string",
"scannerPackages": "string",
"scanners": [
{
"availability": {
"global": false,
"projectIds": [
[
]
]
},
"availableUpdate": "string",
"config": "string",
"direction": "string",
"files": [
{
"id": "string",
"name": "string"
}
],
"id": "string",
"name": "string",
"packageId": "string",
"projectId": "string",
"scannerTemplateId": "string",
"shared": false,
"source": {
"type": "internal"
},
"tags": [
[
]
],
"vendored": false,
"versionMeta": {
"createdAt": "string",
"createdBy": "string",
"description": "string",
"id": "string",
"name": "string",
"published": true
}
}
]
}