> ## 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 PR Data

> Returns pull request activity for all developers in the organization during the specified date range. Includes open/merged/closed PR counts, code change statistics, and detailed PR listings per developer. Useful for code review dashboards and throughput analysis.



## OpenAPI

````yaml /openapi.json post /api/metrics/developer/prs/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.
  - name: Audit Logs
    description: >-
      Read-only access to your organization's audit trail for compliance, ETL
      and SIEM ingestion. Events are immutable, retained for 180 days, and cover
      security-relevant actions: user management, access control, credentials,
      scan triggers, configuration changes and data exports. Secrets and tokens
      are redacted and never appear in any response format.
  - name: Container Scanning
    description: >-
      Container image vulnerability scanning across AWS ECR, Azure ACR, and GCP
      GAR registries. List tracked containers with their latest scan, then fetch
      the full vulnerability findings of a scan — the same data shown on the
      Cloud Security → Container Scanning page. Authenticate with a CodeAnt API
      token (requires the `view_cloud_security: read` permission when token
      scoping is configured).
  - name: Security Hotlist
    description: >-
      The organization-wide security Hotlist: every SCA, SAST, secrets, IaC,
      cloud (CSPM) and AI-exploitation finding, deduplicated and priority-scored
      into one ranked list with live ticket, assignee and SLA state. Query it
      with filters, facets and cursor pagination, or export the full filtered
      list as an Excel workbook. Authenticate with a CodeAnt API token (requires
      the `view_code_security: read` permission when token scoping is
      configured).
paths:
  /api/metrics/developer/prs/get:
    post:
      tags:
        - Developer Metrics
      summary: Get Developer PR Data
      description: >-
        Returns pull request activity for all developers in the organization
        during the specified date range. Includes open/merged/closed PR counts,
        code change statistics, and detailed PR listings per developer. Useful
        for code review dashboards and throughput analysis.
      operationId: getDeveloperPRData
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DateRangeRequest'
            examples:
              github:
                summary: GitHub
                value:
                  platform: github
                  org: my-org
                  start_date: '2025-01-01'
                  end_date: '2025-03-01'
              gitlab:
                summary: GitLab
                value:
                  platform: gitlab
                  org: my-group
                  start_date: '2025-01-01'
                  end_date: '2025-03-01'
              bitbucket:
                summary: Bitbucket
                value:
                  platform: bitbucket
                  org: my-workspace
                  start_date: '2025-01-01'
                  end_date: '2025-03-01'
              azure_devops:
                summary: Azure DevOps
                value:
                  platform: azure_devops
                  org: my-org
                  start_date: '2025-01-01'
                  end_date: '2025-03-01'
      responses:
        '200':
          description: Developer PR data
          content:
            application/json:
              schema:
                type: object
                properties:
                  metric:
                    type: string
                    example: developer_pr_data
                  platform:
                    type: string
                  org:
                    type: string
                  start_date:
                    type: string
                    format: date
                  end_date:
                    type: string
                    format: date
                  developer_pr_data:
                    type: array
                    items:
                      $ref: '#/components/schemas/DeveloperPRData'
                  total_count:
                    type: integer
                    description: Number of developers with PR activity
        '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:
    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'
    DeveloperPRData:
      type: object
      description: A developer's pull request activity and statistics
      properties:
        login:
          type: string
        name:
          type: string
        total_prs:
          type: integer
        open_prs:
          type: integer
        closed_prs:
          type: integer
        merged_prs:
          type: integer
        total_additions:
          type: integer
        total_deletions:
          type: integer
        total_files_changed:
          type: integer
        repositories:
          type: array
          items:
            type: string
        repository_prs:
          type: object
          additionalProperties:
            type: integer
          description: PR count per repository
        pr_creation_dates:
          type: object
          additionalProperties:
            type: integer
          description: PRs created per day
        prs_detail:
          type: array
          description: Detailed list of individual PRs
          items:
            type: object
            properties:
              repository:
                type: string
              pr_number:
                type: integer
              title:
                type: string
              state:
                type: string
                enum:
                  - open
                  - closed
                  - merged
              additions:
                type: integer
              deletions:
                type: integer
              files_changed:
                type: integer
              created_at:
                type: string
                format: date-time
              merged_at:
                type: string
                format: date-time
                nullable: true
    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
    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: >-
        CodeAnt API token (`cdt_...`), created on the Settings → API Tokens
        page. Pass via `Authorization: Bearer <token>` header.

````