Pentest-Tools.com LogoPentest-Tools.com REST API Reference

Scans

Operations done on Scans

Base URL

https://app.pentest-tools.com/api/v2

Endpoints

Method
get
Path
/scans

Get all scans

Query parameters

Property
workspace_id
Type
integer

ID of the workspace to show scans from. If not set, the scans from the active workspace (set in the web interface) will be returneed.

Property
target_id
Type
integer

ID of the target to show scans from

Property
limit
Type

the maximum number of scans to return

Property
page
Type

the page number to return

Responses

Authorization

Use the "API key" from the profile page as the token

Bearer

Request

GET
/scans
curl --request GET \
  --url https://app.pentest-tools.com/api/v2/scans \
  --header 'accept: application/json' \
  --header 'authorization: Bearer {token}'
Method
post
Path
/scans

Start a scan

Request parameters

Content type
application/json
object
Property
tool_id
Type
integer
required
Yes
Property
target_id
Type
integer | null

only one of target_id and target_name should be used

Property
target_name
Type
string | null

only one of target_id and target_name should be used

Property
workspace_id
Type
integer | null

Workspace where the scan is started. It has to match the workspace ID of the target

Property
max_scan_time
Type
integer
min
5
max
1440

Maximum number of minutes that the scan should run. Not supported by: Sniper, tools with short scan duration (like Website Recon or ICMP Ping).

Property
report_callback
Type
object

Send the report in a specific format to this URL when the scan finishes

Property
scan_original_url
Type
boolean
default
 
false

If true, the original URL is passed to the scanner, even if it redirects. If false, the redirected URL will be scanned instead.

Property
redirect_level
Type
string
default
 
"same_domain"

Possible values:

  • none - the target is passed directly to the scanner
  • check_accessibility - the target is checked for accessibility and an error is thrown on any redirect
  • same_host - only redirects within the same host are allowed
  • same_domain - redirects to subdomains are allowed
  • allow_all - any redirects are allowed
Property
tool_params
Type
object

Responses

409Specified workspace ID does not match target workspace ID

Authorization

Use the "API key" from the profile page as the token

Bearer

Request

POST
/scans
curl --request POST \
  --url https://app.pentest-tools.com/api/v2/scans \
  --header 'accept: application/json' \
  --header 'authorization: Bearer {token}'
Method
get
Path
/scans/{id}

Get scan information by ID

Path parameters

Property
id
Type
integer
required
Yes

id of scan

Responses

Authorization

Use the "API key" from the profile page as the token

Bearer

Request

GET
/scans/{id}
curl --request GET \
  --url https://app.pentest-tools.com/api/v2/scans \
  --header 'accept: application/json' \
  --header 'authorization: Bearer {token}'
Method
delete
Path
/scans/{id}

Delete a scan

Path parameters

Property
id
Type
integer
required
Yes

id of scan

Responses

204Deleted successfully
409Task not finished

Authorization

Use the "API key" from the profile page as the token

Bearer

Request

DELETE
/scans/{id}
curl --request DELETE \
  --url https://app.pentest-tools.com/api/v2/scans \
  --header 'accept: application/json' \
  --header 'authorization: Bearer {token}'
Method
get
Path
/scans/{id}/output

Get scan output by ID

Path parameters

Property
id
Type
integer
required
Yes

id of scan

Responses

Authorization

Use the "API key" from the profile page as the token

Bearer

Request

GET
/scans/{id}/output
curl --request GET \
  --url https://app.pentest-tools.com/api/v2/scans/output \
  --header 'accept: application/json' \
  --header 'authorization: Bearer {token}'
Method
post
Path
/scans/{id}/stop

Stop an active scan

Path parameters

Property
id
Type
integer
required
Yes

id of the scan

Responses

204No Content
500Internal server error

Authorization

Use the "API key" from the profile page as the token

Bearer

Request

POST
/scans/{id}/stop
curl --request POST \
  --url https://app.pentest-tools.com/api/v2/scans/stop \
  --header 'accept: application/json' \
  --header 'authorization: Bearer {token}'