> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cybedefend.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get aggregated overview statistics for an organization

> Returns comprehensive vulnerability statistics aggregated across all projects in the organization. Supports filtering by projects, teams, severity, status, analysis types, date ranges, languages, branches, and more. Includes pagination for summaries and period-over-period comparison.



## OpenAPI

````yaml get /organization/{organizationId}/results/overview
openapi: 3.0.0
info:
  title: Cybedefend API
  description: >-
    CybeDefend is an advanced API for application security analysis. Key
    features include OAuth 2.0 authentication, user/organization/project
    management, and REBAC-based permissions. It excels in static, dynamic, and
    IaC security analyses (SAST, DAST, IaC, etc.).
  version: '1.0'
  contact: {}
servers:
  - url: https://api-eu.cybedefend.com
    description: EU
  - url: https://api-us.cybedefend.com
    description: US
security: []
tags: []
paths:
  /organization/{organizationId}/results/overview:
    get:
      tags:
        - Results & Vulnerabilities
      summary: Get aggregated overview statistics for an organization
      description: >-
        Returns comprehensive vulnerability statistics aggregated across all
        projects in the organization. Supports filtering by projects, teams,
        severity, status, analysis types, date ranges, languages, branches, and
        more. Includes pagination for summaries and period-over-period
        comparison.
      operationId: ResultController_getOrganizationOverview
      parameters:
        - name: organizationId
          required: true
          in: path
          schema:
            format: uuid
            type: string
        - name: severityFilter
          required: false
          in: query
          description: >-
            Filter vulnerabilities by severity levels. Only vulnerabilities
            matching these severities will be counted in all statistics.
          schema:
            example: CRITICAL,HIGH
            type: string
            enum:
              - CRITICAL
              - HIGH
              - MEDIUM
              - LOW
        - name: statusFilter
          required: false
          in: query
          description: Filter vulnerabilities by status. Affects all counts and statistics.
          schema:
            example: to_verify,confirmed
            type: string
            enum:
              - to_verify
              - confirmed
              - in_review
              - resolved
              - ignored
        - name: analysisTypes
          required: false
          in: query
          description: Filter vulnerabilities by analysis type (security scanner category).
          schema:
            example: SAST,SCA
            type: string
            enum:
              - SAST
              - SCA
              - IAC
              - CONTAINER
              - CICD
              - SECRET
        - name: includeResolved
          required: false
          in: query
          description: >-
            Include resolved/closed vulnerabilities in all counts. Default:
            false (only open vulnerabilities).
          schema:
            default: false
            example: false
            type: boolean
        - name: dateFrom
          required: false
          in: query
          description: >-
            Start date for filtering vulnerabilities by creation date (ISO 8601
            format).
          schema:
            example: '2024-01-01T00:00:00Z'
            type: string
        - name: dateTo
          required: false
          in: query
          description: >-
            End date for filtering vulnerabilities by creation date (ISO 8601
            format).
          schema:
            example: '2024-12-31T23:59:59Z'
            type: string
        - name: branches
          required: false
          in: query
          description: >-
            Filter vulnerabilities by branch names (comma-separated). Only
            vulnerabilities from these branches will be included in all
            statistics.
          schema:
            type: array
            items:
              type: string
        - name: teamIds
          required: false
          in: query
          description: >-
            Filter data to specific teams by their IDs. Only projects belonging
            to these teams will be included.
          schema:
            example: team-uuid1,team-uuid2
            type: string
        - name: trendPeriodDays
          required: false
          in: query
          description: >-
            Number of days for trend calculation. Affects new/resolved issue
            counts.
          schema:
            minimum: 1
            maximum: 365
            default: 7
            example: 7
            type: number
        - name: comparisonPeriod
          required: false
          in: query
          description: >-
            Comparison period for period-over-period analysis. Enables
            severityComparison and totalComparison in response.
          schema:
            example: week
            type: string
            enum:
              - week
              - month
              - quarter
        - name: projectsPage
          required: false
          in: query
          description: Page number for projects summary pagination.
          schema:
            minimum: 1
            default: 1
            example: 1
            type: number
        - name: projectsPageSize
          required: false
          in: query
          description: Number of projects per page in projectsSummary.
          schema:
            minimum: 1
            maximum: 100
            default: 50
            example: 50
            type: number
        - name: teamsPage
          required: false
          in: query
          description: Page number for teams summary pagination.
          schema:
            minimum: 1
            default: 1
            example: 1
            type: number
        - name: teamsPageSize
          required: false
          in: query
          description: Number of teams per page in teamsSummary.
          schema:
            minimum: 1
            maximum: 100
            default: 50
            example: 50
            type: number
        - name: sortBy
          required: false
          in: query
          description: Sort field for projects and teams summaries. Applied to both lists.
          schema:
            default: total_vulnerabilities
            example: total_vulnerabilities
            type: string
            enum:
              - total_vulnerabilities
              - critical_count
              - risk_level
              - name
        - name: sortOrder
          required: false
          in: query
          description: >-
            Sort direction for projects and teams summaries. DESC = highest
            first.
          schema:
            default: DESC
            example: DESC
            type: string
            enum:
              - ASC
              - DESC
        - name: includeProjectsSummary
          required: false
          in: query
          description: >-
            Include projectsSummary array in response. Disable for faster,
            smaller response.
          schema:
            default: true
            example: true
            type: boolean
        - name: includeTeamsSummary
          required: false
          in: query
          description: >-
            Include teamsSummary array in response. Disable for faster, smaller
            response.
          schema:
            default: true
            example: true
            type: boolean
        - name: includeOverTimeData
          required: false
          in: query
          description: >-
            Include vulnerabilitiesOverTime array for timeline charts. Disable
            if not needed.
          schema:
            default: true
            example: true
            type: boolean
        - name: topVulnerableLimit
          required: false
          in: query
          description: >-
            Limit for topVulnerableProjects array. Returns N most vulnerable
            projects.
          schema:
            minimum: 1
            maximum: 50
            default: 10
            example: 10
            type: number
      responses:
        '200':
          description: Organization overview with aggregated statistics
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetOrganizationOverviewResponseDto'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDto'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                example:
                  message: Unauthorized
                  statusCode: 401
                  timestamp: '2025-02-18T12:31:18.491Z'
                  path: /example/path
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                example:
                  message: Forbidden
                  statusCode: 403
                  timestamp: '2025-02-18T12:31:18.491Z'
                  path: /example/path
components:
  schemas:
    GetOrganizationOverviewResponseDto:
      type: object
      properties:
        organizationId:
          type: string
          description: Organization identifier
        totalProjects:
          type: number
          description: Total number of projects in the organization
        totalTeams:
          type: number
          description: Total number of teams in the organization
        totalBySeverity:
          type: array
          items:
            $ref: '#/components/schemas/TotalBySeverityDto'
        totalByState:
          type: array
          items:
            $ref: '#/components/schemas/TotalByStateDto'
        totalByAnalysisType:
          type: array
          items:
            $ref: '#/components/schemas/TotalByAnalysisTypeDto'
        vulnerabilitiesOverTime:
          type: array
          items:
            $ref: '#/components/schemas/VulnerabilitiesOverTimeDto'
        projectsSummary:
          type: array
          items:
            $ref: '#/components/schemas/ProjectOverviewSummaryDto'
        teamsSummary:
          type: array
          items:
            $ref: '#/components/schemas/TeamOverviewSummaryDto'
        topVulnerableProjects:
          type: array
          items:
            $ref: '#/components/schemas/TopVulnerableProjectDto'
        criticalRiskProjects:
          type: number
          description: Number of projects with critical risk level
        highRiskProjects:
          type: number
          description: Number of projects with high risk level
        mediumRiskProjects:
          type: number
          description: Number of projects with medium risk level
        lowRiskProjects:
          type: number
          description: Number of projects with low or no risk level
        newIssuesLast7Days:
          type: number
          description: Number of new issues discovered in the last 7 days
        solvedIssuesLast7Days:
          type: number
          description: Number of issues resolved in the last 7 days
        solvedIssues:
          type: number
          description: Total number of resolved issues
        newIssues:
          type: number
          description: Total number of new issues (all time)
        criticalIssues:
          type: number
          description: Total number of critical severity issues
        highIssues:
          type: number
          description: Total number of high severity issues
        mediumIssues:
          type: number
          description: Total number of medium severity issues
        lowIssues:
          type: number
          description: Total number of low severity issues
      required:
        - organizationId
        - totalProjects
        - totalTeams
        - totalBySeverity
        - totalByState
        - totalByAnalysisType
        - vulnerabilitiesOverTime
        - projectsSummary
        - teamsSummary
        - topVulnerableProjects
        - criticalRiskProjects
        - highRiskProjects
        - mediumRiskProjects
        - lowRiskProjects
        - newIssuesLast7Days
        - solvedIssuesLast7Days
        - solvedIssues
        - newIssues
        - criticalIssues
        - highIssues
        - mediumIssues
        - lowIssues
    ErrorDto:
      type: object
      properties:
        timestamp:
          type: string
          example: '2025-02-18T12:31:18.491Z'
          description: Timestamp of the error
        service:
          type: string
          example: AiService
          description: Name of the service where the error occurred
        method:
          type: string
          example: startConversation
          description: Method name where the error occurred
        message:
          type: string
          example: Invalid parameters provided
          description: Error message
        code:
          type: number
          example: 400
          description: HTTP status code
          minimum: 100
          maximum: 599
      required:
        - timestamp
        - service
        - method
        - message
        - code
    TotalBySeverityDto:
      type: object
      properties:
        severity:
          type: string
          description: Severity level
        count:
          type: number
          description: Number of vulnerabilities for the given severity
      required:
        - severity
        - count
    TotalByStateDto:
      type: object
      properties:
        state:
          type: string
          description: State of the vulnerability
        count:
          type: number
          description: Number of vulnerabilities for the given state
      required:
        - state
        - count
    TotalByAnalysisTypeDto:
      type: object
      properties:
        analysisType:
          type: string
          description: Type of analysis (SAST, IAC, SCA, etc.)
        count:
          type: number
          description: Number of vulnerabilities for the given analysis type
      required:
        - analysisType
        - count
    VulnerabilitiesOverTimeDto:
      type: object
      properties:
        date:
          type: string
          description: Date of the aggregation
        severity:
          type: number
          description: Number of vulnerabilities for the given date
        count:
          type: number
          description: Number of vulnerabilities for the given date
      required:
        - date
        - severity
        - count
    ProjectOverviewSummaryDto:
      type: object
      properties:
        projectId:
          type: string
          description: Unique project identifier
        projectName:
          type: string
          description: Project name
        teamId:
          type: string
          description: Team identifier
        teamName:
          type: string
          description: Team name
        riskLevel:
          type: string
          description: Risk level of the project (critical, high, medium, low)
        criticalCount:
          type: number
          description: Number of critical severity vulnerabilities
        highCount:
          type: number
          description: Number of high severity vulnerabilities
        mediumCount:
          type: number
          description: Number of medium severity vulnerabilities
        lowCount:
          type: number
          description: Number of low severity vulnerabilities
        totalVulnerabilities:
          type: number
          description: Total number of vulnerabilities in the project
        sastCount:
          type: number
          description: Number of SAST vulnerabilities
        scaCount:
          type: number
          description: Number of SCA vulnerabilities
        iacCount:
          type: number
          description: Number of IAC vulnerabilities
        containerCount:
          type: number
          description: Number of Container vulnerabilities
      required:
        - projectId
        - projectName
        - teamId
        - teamName
        - riskLevel
        - criticalCount
        - highCount
        - mediumCount
        - lowCount
        - totalVulnerabilities
        - sastCount
        - scaCount
        - iacCount
        - containerCount
    TeamOverviewSummaryDto:
      type: object
      properties:
        teamId:
          type: string
          description: Team identifier
        teamName:
          type: string
          description: Team name
        projectCount:
          type: number
          description: Number of projects in the team
        criticalCount:
          type: number
          description: Number of critical severity vulnerabilities
        highCount:
          type: number
          description: Number of high severity vulnerabilities
        mediumCount:
          type: number
          description: Number of medium severity vulnerabilities
        lowCount:
          type: number
          description: Number of low severity vulnerabilities
        totalVulnerabilities:
          type: number
          description: Total number of vulnerabilities in the team
        criticalRiskProjects:
          type: number
          description: Number of projects with critical risk level
        highRiskProjects:
          type: number
          description: Number of projects with high risk level
        mediumRiskProjects:
          type: number
          description: Number of projects with medium risk level
        lowRiskProjects:
          type: number
          description: Number of projects with low risk level
      required:
        - teamId
        - teamName
        - projectCount
        - criticalCount
        - highCount
        - mediumCount
        - lowCount
        - totalVulnerabilities
        - criticalRiskProjects
        - highRiskProjects
        - mediumRiskProjects
        - lowRiskProjects
    TopVulnerableProjectDto:
      type: object
      properties:
        projectId:
          type: string
          description: Unique project identifier
        projectName:
          type: string
          description: Project name
        teamName:
          type: string
          description: Team name
        vulnerabilityCount:
          type: number
          description: Total number of vulnerabilities
        criticalCount:
          type: number
          description: Number of critical severity vulnerabilities
        highCount:
          type: number
          description: Number of high severity vulnerabilities
        riskLevel:
          type: string
          description: Risk level of the project
        openCount:
          type: number
          description: Number of open vulnerabilities
        newLast7Days:
          type: number
          description: Number of new vulnerabilities in last 7 days
        teamId:
          type: string
          description: Team identifier
      required:
        - projectId
        - projectName
        - teamName
        - vulnerabilityCount
        - criticalCount
        - highCount
        - riskLevel
        - openCount
        - newLast7Days

````