- Documentation Home
- Community
- Introduction
Assets
Auto Discovery
Templates
Scans
- GETGet Scan List
- POSTCreate Scan
- GETGet Scan
- GETGet Scan IPs
- GETGet Scans Token
- DELDelete Scan
- PATCHUpdate Scan
- POSTStop Scan
- POSTRescan scan
- POSTImport OSS Scan
- PATCHUpdate Imported Scan
- GETGet Scan Schedules
- POSTSet Scan Schedule
- DELDelete Scan Schedule
- GETGet All Scan Stats
- GETGet All Scans History
- GETGet Scan History
- GETGet Scan Config
- PATCHUpdate Scan Config
- POSTRetest vulnerability
- DELDelete Scan Vulnerability
- GETExport Scan Vulnerability
- POSTExport Filtered Scan
- GETExport Scan
- POSTCreate vulns export to tracker
- PATCHUpdate Vulnerability Labels
- PATCHUpdate Vulnerability Status
- GET
Configurations
Results
Retests
Scan Logs
Error Logs
Users
API Reference
Get Scan List
Get user scans status
number of scan-status results to skip
number of scan-status results to fetch
search term for running scans
filter by status (failed, finished, queued, running, starting, uploaded, scheduled)
comma separated ascending sorting e.g sort_asc=created_at,severity
comma separated descending sorting e.g sort_desc=created_at,severity
curl --request GET \
--url https://api.projectdiscovery.io/v1/scans \
--header 'X-API-Key: <api-key>'
{
"current_page": 123,
"result_count": 123,
"total_results": 123,
"total_pages": 123,
"message": "<string>",
"data": [
{
"scan_id": "<string>",
"status": "<string>",
"scan_time_elapsed": "<string>",
"progress": 123,
"failure_reason": "<string>",
"created_at": "<string>",
"updated_at": "<string>",
"total_target": 123,
"completed_at": "<string>",
"total_scan": 123,
"total_template": 123,
"name": "<string>",
"severity": {},
"is_oss": true,
"is_cloud": true,
"asset_ids": [
"<string>"
],
"is_rescan": true,
"public_templates": [
"<string>"
],
"report_config_ids": [
"<string>"
],
"rescan_count": 123,
"scan_config_ids": [
"<string>"
],
"template_ids": [
"<string>"
],
"template_urls": [
"<string>"
],
"schedule": {
"scan_frequency": "<string>",
"scan_id": "<string>",
"schedule_last_run": "<string>",
"schedule_next_run": "<string>",
"start_time": "<string>",
"hourly_frequency": 123,
"custom_weekdays": [
3
]
}
}
]
}
Authorizations
Query Parameters
number of scan-status results to skip
number of scan-status results to fetch
search term for running scans
filter by status (failed, finished, queued, running, starting, uploaded, scheduled)
comma separated ascending sorting e.g sort_asc=created_at,severity
comma separated descending sorting e.g sort_desc=created_at,severity
Response
Array of integer denoting the weekdays on which the scan is supposed to run. 0-6 denoting Sunday-Saturday.
Was this page helpful?
curl --request GET \
--url https://api.projectdiscovery.io/v1/scans \
--header 'X-API-Key: <api-key>'
{
"current_page": 123,
"result_count": 123,
"total_results": 123,
"total_pages": 123,
"message": "<string>",
"data": [
{
"scan_id": "<string>",
"status": "<string>",
"scan_time_elapsed": "<string>",
"progress": 123,
"failure_reason": "<string>",
"created_at": "<string>",
"updated_at": "<string>",
"total_target": 123,
"completed_at": "<string>",
"total_scan": 123,
"total_template": 123,
"name": "<string>",
"severity": {},
"is_oss": true,
"is_cloud": true,
"asset_ids": [
"<string>"
],
"is_rescan": true,
"public_templates": [
"<string>"
],
"report_config_ids": [
"<string>"
],
"rescan_count": 123,
"scan_config_ids": [
"<string>"
],
"template_ids": [
"<string>"
],
"template_urls": [
"<string>"
],
"schedule": {
"scan_frequency": "<string>",
"scan_id": "<string>",
"schedule_last_run": "<string>",
"schedule_next_run": "<string>",
"start_time": "<string>",
"hourly_frequency": 123,
"custom_weekdays": [
3
]
}
}
]
}