Security

List security findings

Returns the findings of a project across all scans, filtered as you need them. A pipeline that only wants to know whether anything new broke should filter on status=open and on the severities it cares about.

get/api/projects/{projectId}/security/findings

Request

  • Base URL: https://api.routebase.dev
  • URL: https://api.routebase.dev/api/projects/{projectId}/security/findings
  • Auth: API key in header X-API-Key

Path parameters

ProjectIdstring uuid required

Public id of the project.

Query parameters

assignedToMeboolean

Return only findings assigned to the calling user.

scannerIdstring

Filter by the scanner that produced the finding.

searchstring

Free-text search across title and description.

severity'info' | 'low' | 'medium' | 'high' | 'critical'

How serious a security finding is.

Filter by severity.

Skipinteger

Number of items to skip. Defaults to 0.

sortBystring

Sort order of the result.

status'open' | 'inProgress' | 'fixed' | 'falsePositive' | 'acceptedRisk' | 'duplicate'

Where a finding stands in triage.

Filter by finding status.

takeinteger

Maximum number of items to return. Defaults to 50.

Headers

X-RB-Regionstring
Example:us

Region of your organization. US organizations must send us; EU organizations leave the header out. Without it a US call is routed to the EU region and answered with 401.

Response

A page of findings.

totalinteger required

Total number of matching findings, ignoring paging.

skipinteger required

How many findings were skipped to reach this page.

takeinteger required

Page size that was applied.

Changes

No recorded changes to this operation across all 1 revision of this API.