Skip to content

List issues

GET
/v1/issues
curl --request GET \
--url 'https://api.devsecure.io/v1/issues?limit=50&sort=-created_at&latest_only=true' \
--header 'Authorization: Bearer <token>'

Issues (findings) across the workspace. By default only issues from the latest scan of each repository or target are included (latest_only=true), as in the dashboard.

limit
Limit

Page size (1-200).

integer
default: 50 >= 1 <= 200

Page size (1-200).

cursor
Any of:
string
<= 1024 characters

Opaque cursor from the previous page.

sort
Sort
string
default: -created_at
Allowed values: -created_at -severity
severity
Severity
Array<string>
default:
Allowed values: critical high medium low info
status
Status
Array<string>
default:
Allowed values: open resolved snoozed false_positive accepted_risk
scan_type
Scan Type
Array<string>
default:
Allowed values: code upload dast container pentest cms other
scanner
Scanner

Scanner tool name, e.g. semgrep.

Array<string>
default: <= 10 items

Scanner tool name, e.g. semgrep.

scan_id
Any of:
string
<= 20 characters
repository_id
Any of:
string
<= 64 characters
group_id
Any of:
string
<= 64 characters
cwe
Any of:
integer
>= 1 <= 100000
cve
Any of:
string
<= 50 characters
q
Any of:
string
>= 1 characters <= 100 characters

Case-insensitive title contains.

created_after
Any of:
string format: date-time

Inclusive, ISO 8601.

created_before
Any of:
string format: date-time

Exclusive, ISO 8601.

latest_only
Latest Only

Only issues from the latest scan of each repository or target, as in the dashboard.

boolean
default: true

Only issues from the latest scan of each repository or target, as in the dashboard.

OK.

Media typeapplication/json
IssueList
object
data
required
Data
Array<object>
IssueSummary
object
id
required
Id
string format: uuid
title
required
Title
string
severity
required
Severity
string
Allowed values: critical high medium low info
status
required
Status
string
Allowed values: open resolved snoozed false_positive accepted_risk
status_reason
Any of:
string
status_expires_at
Any of:
string
status_changed_at
Any of:
string
scanner
Any of:
string
scanner_confidence
Any of:
string
cwe
Any of:
integer
cve
Any of:
string
cvss_score
Any of:
number
file_path
Any of:
string
line_number
Any of:
integer
function_name
Any of:
string
language
Any of:
string
risk_priority_score
Any of:
integer
remediation_safety_score
Any of:
integer
fingerprint
Any of:
string
reopened
required
Reopened

True when this issue recurred after being marked a false positive.

boolean
scan_id
required
Scan Id
string
scan_type
required
Scan Type
string
Allowed values: code upload dast container pentest cms other
repository
Any of:
ScanRepository
object
id
required
Id
string
provider
required
Provider
string
Allowed values: github gitlab bitbucket container
name
required
Name
string
target
Any of:
string
first_seen_at
Any of:
string
created_at
Any of:
string
updated_at
Any of:
string
pagination
required
PageInfo
object
next_cursor
required
Any of:
string
has_more
required
Has More
boolean
Example
{
"data": [
{
"title": "SQL injection in query builder",
"severity": "critical",
"status": "open",
"scanner": "semgrep",
"cwe": 89,
"cve": "CVE-2024-12345",
"file_path": "app/db/query.py",
"scan_type": "code",
"repository": {
"id": "repo_3f9a0c2d4b1e8f7a6c5d4e3f",
"provider": "github",
"name": "acme/payments-api"
}
}
]
}
X-Request-ID
string

Identifies the request; quote it to support.

X-RateLimit-Limit
integer

Requests allowed per window.

X-RateLimit-Remaining
integer

Requests left in the window.

X-RateLimit-Reset
integer

Seconds until the window resets.

X-Has-Next-Page
string
Allowed values: true false

Whether another page follows.

The request is not valid (validation_error, invalid_cursor).

Media typeapplication/json
ErrorEnvelope
object
error
required
ErrorBody
object
code
required
Code
string
message
required
Message
string
request_id
required
Any of:
string
details
Any of:
Array<object>
ErrorDetail
object
field
Any of:
string
message
required
Message
string
Example
{
"error": {
"code": "validation_error",
"message": "The request is not valid.",
"request_id": "req_3f0c2a9d5b6e4f7a8c1d2e3f4a5b6c7d"
}
}
X-Request-ID
string

Identifies the request; quote it to support.

Missing, unknown, expired or revoked credential (invalid_credentials).

Media typeapplication/json
ErrorEnvelope
object
error
required
ErrorBody
object
code
required
Code
string
message
required
Message
string
request_id
required
Any of:
string
details
Any of:
Array<object>
ErrorDetail
object
field
Any of:
string
message
required
Message
string
Example
{
"error": {
"code": "invalid_credentials",
"message": "The credential is missing, invalid, expired or revoked.",
"request_id": "req_3f0c2a9d5b6e4f7a8c1d2e3f4a5b6c7d"
}
}
X-Request-ID
string

Identifies the request; quote it to support.

The credential may not do this (insufficient_scope, permission_denied, plan_not_allowed, quota_exceeded, target_not_authorized).

Media typeapplication/json
ErrorEnvelope
object
error
required
ErrorBody
object
code
required
Code
string
message
required
Message
string
request_id
required
Any of:
string
details
Any of:
Array<object>
ErrorDetail
object
field
Any of:
string
message
required
Message
string
Example
{
"error": {
"code": "insufficient_scope",
"message": "The credential does not have the scope this operation needs.",
"request_id": "req_3f0c2a9d5b6e4f7a8c1d2e3f4a5b6c7d"
}
}
X-Request-ID
string

Identifies the request; quote it to support.

Too many requests (rate_limited).

Media typeapplication/json
ErrorEnvelope
object
error
required
ErrorBody
object
code
required
Code
string
message
required
Message
string
request_id
required
Any of:
string
details
Any of:
Array<object>
ErrorDetail
object
field
Any of:
string
message
required
Message
string
Example
{
"error": {
"code": "rate_limited",
"message": "Too many requests. Retry after the time in Retry-After.",
"request_id": "req_3f0c2a9d5b6e4f7a8c1d2e3f4a5b6c7d"
}
}
X-Request-ID
string

Identifies the request; quote it to support.

X-RateLimit-Limit
integer

Requests allowed per window.

X-RateLimit-Remaining
integer

Requests left in the window.

X-RateLimit-Reset
integer

Seconds until the window resets.

Retry-After
integer

Seconds to wait before retrying.

Unexpected error (internal_error). Quote the request id to support.

Media typeapplication/json
ErrorEnvelope
object
error
required
ErrorBody
object
code
required
Code
string
message
required
Message
string
request_id
required
Any of:
string
details
Any of:
Array<object>
ErrorDetail
object
field
Any of:
string
message
required
Message
string
Example
{
"error": {
"code": "internal_error",
"message": "Something went wrong on our side.",
"request_id": "req_3f0c2a9d5b6e4f7a8c1d2e3f4a5b6c7d"
}
}
X-Request-ID
string

Identifies the request; quote it to support.