Skip to content
DevSecure API

Count issues

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

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
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.

Responses

Section titled “Responses”

200

Section titled “200”

OK.

Media typeapplication/json
IssueCounts
object
total
required
Total
integer
by_severity
required
By Severity
object
key
additional properties
integer
by_status
required
By Status
object
key
additional properties
integer
by_scan_type
required
By Scan Type
object
key
additional properties
integer
Examplegenerated
{
  "total": 1,
  "by_severity": {
    "additionalProperty": 1
  },
  "by_status": {
    "additionalProperty": 1
  },
  "by_scan_type": {
    "additionalProperty": 1
  }
}

Headers

Section titled “Headers”
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.

400

Section titled “400”

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"
  }
}

Headers

Section titled “Headers”
X-Request-ID
string

Identifies the request; quote it to support.

401

Section titled “401”

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"
  }
}

Headers

Section titled “Headers”
X-Request-ID
string

Identifies the request; quote it to support.

403

Section titled “403”

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"
  }
}

Headers

Section titled “Headers”
X-Request-ID
string

Identifies the request; quote it to support.

429

Section titled “429”

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"
  }
}

Headers

Section titled “Headers”
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.

500

Section titled “500”

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"
  }
}

Headers

Section titled “Headers”
X-Request-ID
string

Identifies the request; quote it to support.