Pentests
List pentests
Returns a paginated list of all pentests (security scans) in your organization.
Required permission: pentests:read
Authorization
ApiKeyAuth X-API-Key<token>
API key for authentication. Create API keys in Settings > API Keys.
Format: mpt_<32 hex characters>
In: header
Query Parameters
limit?integer
Maximum number of items to return
Default
20Range
1 <= value <= 100offset?integer
Number of items to skip for pagination
Default
0Range
0 <= valueapplication_id?string
Filter by application ID
status?string
Filter by status (comma-separated for multiple)
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.modernpentest.com/api/v1/pentests?status=completed%2Crunning"{
"pentests": [
{
"id": "string",
"application_id": "string",
"application_name": "string",
"status": "pending",
"scan_type": "manual",
"queued_at": 0,
"started_at": 0,
"completed_at": 0,
"duration": 0,
"progress_percentage": 100,
"risk_level": "critical",
"risk_score": 0,
"vulnerabilities_found": 0,
"severity_breakdown": {
"critical": 0,
"high": 0,
"medium": 0,
"low": 0,
"info": 0
},
"configuration": {
"owasp_tests": [
"string"
],
"depth": "shallow",
"max_duration": 0
},
"error": {
"code": "string",
"message": "string"
},
"created_at": 0
}
],
"pagination": {
"total": 0,
"limit": 0,
"offset": 0,
"has_more": true
}
}{
"error": {
"code": "UNAUTHENTICATED",
"message": "Invalid or missing API key",
"timestamp": 1734567890000
}
}{
"error": {
"code": "FORBIDDEN",
"message": "Missing required permission: applications:read",
"timestamp": 1734567890000
}
}{
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "Rate limit exceeded. Try again in 45 seconds.",
"timestamp": 1734567890000
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "An unexpected error occurred",
"timestamp": 1734567890000
}
}Last updated: February 1, 2026