Skip to main content
GET
/
organization
/
{organizationId}
/
results
/
overview
Get aggregated overview statistics for an organization
curl --request GET \
  --url https://api-eu.cybedefend.com/organization/{organizationId}/results/overview \
  --header 'x-api-key: <api-key>'
{
  "organizationId": "<string>",
  "totalProjects": 123,
  "totalTeams": 123,
  "totalBySeverity": [
    {
      "severity": "<string>",
      "count": 123
    }
  ],
  "totalByState": [
    {
      "state": "<string>",
      "count": 123
    }
  ],
  "totalByAnalysisType": [
    {
      "analysisType": "<string>",
      "count": 123
    }
  ],
  "vulnerabilitiesOverTime": [
    {
      "date": "<string>",
      "severity": 123,
      "count": 123
    }
  ],
  "projectsSummary": [
    {
      "projectId": "<string>",
      "projectName": "<string>",
      "teamId": "<string>",
      "teamName": "<string>",
      "riskLevel": "<string>",
      "criticalCount": 123,
      "highCount": 123,
      "mediumCount": 123,
      "lowCount": 123,
      "totalVulnerabilities": 123,
      "sastCount": 123,
      "scaCount": 123,
      "iacCount": 123,
      "containerCount": 123
    }
  ],
  "teamsSummary": [
    {
      "teamId": "<string>",
      "teamName": "<string>",
      "projectCount": 123,
      "criticalCount": 123,
      "highCount": 123,
      "mediumCount": 123,
      "lowCount": 123,
      "totalVulnerabilities": 123,
      "criticalRiskProjects": 123,
      "highRiskProjects": 123,
      "mediumRiskProjects": 123,
      "lowRiskProjects": 123
    }
  ],
  "topVulnerableProjects": [
    {
      "projectId": "<string>",
      "projectName": "<string>",
      "teamName": "<string>",
      "vulnerabilityCount": 123,
      "criticalCount": 123,
      "highCount": 123,
      "riskLevel": "<string>",
      "openCount": 123,
      "newLast7Days": 123,
      "teamId": "<string>"
    }
  ],
  "criticalRiskProjects": 123,
  "highRiskProjects": 123,
  "mediumRiskProjects": 123,
  "lowRiskProjects": 123,
  "newIssuesLast7Days": 123,
  "solvedIssuesLast7Days": 123,
  "solvedIssues": 123,
  "newIssues": 123,
  "criticalIssues": 123,
  "highIssues": 123,
  "mediumIssues": 123,
  "lowIssues": 123
}

Authorizations

x-api-key
string
header
required

API Key for authentication. You can generate an API key from your personal settings.

Path Parameters

organizationId
string<uuid>
required

Query Parameters

severityFilter
enum<string>

Filter vulnerabilities by severity levels. Only vulnerabilities matching these severities will be counted in all statistics.

Available options:
CRITICAL,
HIGH,
MEDIUM,
LOW
Example:

"CRITICAL,HIGH"

statusFilter
enum<string>

Filter vulnerabilities by status. Affects all counts and statistics.

Available options:
to_verify,
confirmed,
in_review,
resolved,
not_exploitable,
ignored
Example:

"to_verify,confirmed"

analysisTypes
enum<string>

Filter vulnerabilities by analysis type (security scanner category).

Available options:
SAST,
SCA,
IAC,
CONTAINER,
CICD,
SECRET
Example:

"SAST,SCA"

includeResolved
boolean
default:false

Include resolved/closed vulnerabilities in all counts. Default: false (only open vulnerabilities).

Example:

false

dateFrom
string

Start date for filtering vulnerabilities by creation date (ISO 8601 format).

Example:

"2024-01-01T00:00:00Z"

dateTo
string

End date for filtering vulnerabilities by creation date (ISO 8601 format).

Example:

"2024-12-31T23:59:59Z"

branches
string[]

Filter vulnerabilities by branch names (comma-separated). Only vulnerabilities from these branches will be included in all statistics.

teamIds
string

Filter data to specific teams by their IDs. Only projects belonging to these teams will be included.

Example:

"team-uuid1,team-uuid2"

trendPeriodDays
number
default:7

Number of days for trend calculation. Affects new/resolved issue counts.

Required range: 1 <= x <= 365
Example:

7

comparisonPeriod
enum<string>

Comparison period for period-over-period analysis. Enables severityComparison and totalComparison in response.

Available options:
week,
month,
quarter
Example:

"week"

projectsPage
number
default:1

Page number for projects summary pagination.

Required range: x >= 1
Example:

1

projectsPageSize
number
default:50

Number of projects per page in projectsSummary.

Required range: 1 <= x <= 100
Example:

50

teamsPage
number
default:1

Page number for teams summary pagination.

Required range: x >= 1
Example:

1

teamsPageSize
number
default:50

Number of teams per page in teamsSummary.

Required range: 1 <= x <= 100
Example:

50

sortBy
enum<string>
default:total_vulnerabilities

Sort field for projects and teams summaries. Applied to both lists.

Available options:
total_vulnerabilities,
critical_count,
risk_level,
name
Example:

"total_vulnerabilities"

sortOrder
enum<string>
default:DESC

Sort direction for projects and teams summaries. DESC = highest first.

Available options:
ASC,
DESC
Example:

"DESC"

includeProjectsSummary
boolean
default:true

Include projectsSummary array in response. Disable for faster, smaller response.

Example:

true

includeTeamsSummary
boolean
default:true

Include teamsSummary array in response. Disable for faster, smaller response.

Example:

true

includeOverTimeData
boolean
default:true

Include vulnerabilitiesOverTime array for timeline charts. Disable if not needed.

Example:

true

topVulnerableLimit
number
default:10

Limit for topVulnerableProjects array. Returns N most vulnerable projects.

Required range: 1 <= x <= 50
Example:

10

Response

Organization overview with aggregated statistics

organizationId
string
required

Organization identifier

totalProjects
number
required

Total number of projects in the organization

totalTeams
number
required

Total number of teams in the organization

totalBySeverity
object[]
required
totalByState
object[]
required
totalByAnalysisType
object[]
required
vulnerabilitiesOverTime
object[]
required
projectsSummary
object[]
required
teamsSummary
object[]
required
topVulnerableProjects
object[]
required
criticalRiskProjects
number
required

Number of projects with critical risk level

highRiskProjects
number
required

Number of projects with high risk level

mediumRiskProjects
number
required

Number of projects with medium risk level

lowRiskProjects
number
required

Number of projects with low or no risk level

newIssuesLast7Days
number
required

Number of new issues discovered in the last 7 days

solvedIssuesLast7Days
number
required

Number of issues resolved in the last 7 days

solvedIssues
number
required

Total number of resolved issues

newIssues
number
required

Total number of new issues (all time)

criticalIssues
number
required

Total number of critical severity issues

highIssues
number
required

Total number of high severity issues

mediumIssues
number
required

Total number of medium severity issues

lowIssues
number
required

Total number of low severity issues