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

# Get Developer Comparison

> Retrieves a developer's productivity metrics compared against the organization average. Includes commit activity, PR statistics, code review contributions, and more. Useful for individual performance dashboards and 1:1 reviews.



## OpenAPI

````yaml /openapi.json post /api/metrics/developer/comparison/get
openapi: 3.0.3
info:
  title: CodeAnt AI API
  description: >-
    API for code analysis (SAST, SCA, secrets, IaC) and developer productivity
    metrics. Supports GitHub, GitLab, Bitbucket, and Azure DevOps.
  version: 1.0.0
servers:
  - url: https://api.codeant.ai
    description: Production server
security: []
tags:
  - name: Analysis
    description: Code analysis operations
  - name: Agent Analysis
    description: >-
      AI-powered agent analysis operations. Uses LLM-based code exploration
      agents to perform deep security threat hunting, bug finding, and custom
      analysis with reflection-based false positive filtering.
  - name: Developer Metrics — Teams
    description: >-
      Manage developer teams: create, update, delete teams and manage team
      membership. Teams are used to organize developers and scope metrics.
  - name: Developer Metrics
    description: >-
      Developer productivity and activity metrics: active developers, PR
      throughput, individual comparisons, and AI-generated summaries. All
      endpoints support GitHub, GitLab, Bitbucket, and Azure DevOps.
paths:
  /api/metrics/developer/comparison/get:
    post:
      tags:
        - Developer Metrics
      summary: Get Developer Comparison
      description: >-
        Retrieves a developer's productivity metrics compared against the
        organization average. Includes commit activity, PR statistics, code
        review contributions, and more. Useful for individual performance
        dashboards and 1:1 reviews.
      operationId: getDevComparison
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DevComparisonRequest'
            examples:
              github:
                summary: GitHub
                value:
                  platform: github
                  org: my-org
                  author: janedoe
                  start_date: '2025-01-01'
                  end_date: '2025-03-01'
              gitlab:
                summary: GitLab
                value:
                  platform: gitlab
                  org: my-group
                  author: janedoe
                  start_date: '2025-01-01'
                  end_date: '2025-03-01'
              bitbucket:
                summary: Bitbucket
                value:
                  platform: bitbucket
                  org: my-workspace
                  author: janedoe
                  start_date: '2025-01-01'
                  end_date: '2025-03-01'
              azure_devops:
                summary: Azure DevOps
                value:
                  platform: azure_devops
                  org: my-org
                  author: janedoe
                  start_date: '2025-01-01'
                  end_date: '2025-03-01'
      responses:
        '200':
          description: Developer comparison data
          content:
            application/json:
              schema:
                type: object
                properties:
                  metric:
                    type: string
                    example: dev_comparison
                  platform:
                    type: string
                  org:
                    type: string
                  author:
                    type: string
                  start_date:
                    type: string
                    format: date
                  end_date:
                    type: string
                    format: date
                  org_context:
                    type: object
                    description: Organization-wide averages and context data
                  developer:
                    type: object
                    description: Individual developer metrics and activity data
        '400':
          description: Bad request — missing or invalid parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DevMetricsErrorResponse'
              example:
                error: 'Missing required parameters: platform, org'
        '401':
          description: Unauthorized — missing, invalid, or insufficient access token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DevMetricsErrorResponse'
              examples:
                missing_token:
                  summary: Missing Authorization header
                  value:
                    error: Missing Authorization header. Use 'Bearer <access_token>'
                invalid_token:
                  summary: Invalid or insufficient token
                  value:
                    error: >-
                      Access token invalid or does not have access to this
                      organization
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DevMetricsStatusResponse'
              example:
                status: error
                message: Internal server error
      security:
        - BearerAuth: []
components:
  schemas:
    DevComparisonRequest:
      allOf:
        - $ref: '#/components/schemas/DateRangeRequest'
        - type: object
          required:
            - author
          properties:
            author:
              type: string
              description: Git author login/email to analyze
              example: janedoe
    DevMetricsErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Error message
    DevMetricsStatusResponse:
      type: object
      properties:
        status:
          type: string
          enum:
            - success
            - error
        message:
          type: string
          description: Human-readable status message
    DateRangeRequest:
      allOf:
        - $ref: '#/components/schemas/DevMetricsBaseRequest'
        - type: object
          required:
            - start_date
            - end_date
          properties:
            start_date:
              type: string
              format: date
              description: Start of the date range (YYYY-MM-DD)
              example: '2025-01-01'
            end_date:
              type: string
              format: date
              description: End of the date range (YYYY-MM-DD)
              example: '2025-03-01'
    DevMetricsBaseRequest:
      type: object
      required:
        - platform
        - org
      properties:
        platform:
          type: string
          description: Version control platform
          enum:
            - github
            - gitlab
            - bitbucket
            - azure_devops
            - azuredevops
          example: github
        org:
          type: string
          description: Organization, workspace, or group name on the platform
          example: my-org
        github_base_url:
          type: string
          description: Base URL for GitHub (use for GitHub Enterprise Server)
          default: https://github.com
          example: https://github.com
        gitlab_base_url:
          type: string
          description: Base URL for GitLab (use for self-hosted GitLab instances)
          default: https://gitlab.com
          example: https://gitlab.com
        azure_devops_base_url:
          type: string
          description: Base URL for Azure DevOps (use for Azure DevOps Server)
          default: https://dev.azure.com
          example: https://dev.azure.com
        bitbucket_base_url:
          type: string
          description: Base URL for Bitbucket (use for Bitbucket Data Center/Server)
          default: https://api.bitbucket.org/2.0
          example: https://api.bitbucket.org/2.0
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        Access token for the git provider (GitHub PAT, GitLab PAT, Bitbucket App
        Password, Azure DevOps PAT). Pass via `Authorization: Bearer <token>`
        header.

````