Analytics Insights

Rich analytics including merge time, per-author stats, verdict breakdown, and issue categories

Endpoint

GET /api/v1/analytics/insights

Returns comprehensive analytics insights including merge time metrics, per-author statistics, AI verdict breakdown, confidence distribution, issue categories, and per-repository breakdown.

Authentication

Requires a valid JWT token in cookies (obtained via GitHub OAuth).

Query Parameters

days · integer · default: 30

Number of days to analyze (7-90)

Response

period · object

Analysis time period

Show properties

start · string

Start date (ISO 8601)

end · string

End date (ISO 8601)

days · integer

Number of days analyzed

merge_metrics · object

Pull request merge time statistics

Show properties

median_hours · number

Median time from PR creation to merge

p90_hours · number

90th percentile merge time

count · integer

Number of merged PRs analyzed

authors · array

Per-author statistics sorted by PR count

Show properties

author · string

GitHub username

prs · integer

Total PRs created

merged · integer

Number of merged PRs

issues_flagged · integer

Total issues identified in reviews

avg_confidence · number

Average AI review confidence (1-5)

verdicts · object

AI review verdict distribution

Show properties

APPROVE · integer

Number of approved PRs

REQUEST_CHANGES · integer

Number of PRs requesting changes

NEEDS_DISCUSSION · integer

Number of PRs needing discussion

confidence_dist · object

AI confidence score distribution (1=low, 5=high)

issue_categories · object

Issue severity breakdown

Show properties

critical · integer

Critical issues found

moderate · integer

Moderate issues found

minor · integer

Minor issues found

repos · array

Per-repository metrics sorted by PR count

Show properties

repo · string

Repository full name (owner/repo)

prs · integer

Number of PRs

merged · integer

Number of merged PRs

issues_flagged · integer

Total issues flagged

pr_size · object

PR size distribution (lines changed)

Show properties

median · integer

Median lines changed

p90 · integer

90th percentile size

Example Request

cURL

curl "https://your-backend.railway.app/api/v1/analytics/insights?days=30" \
  -H "Cookie: access_token=your_jwt_token"

Example Response

{
  "period": {
    "start": "2026-02-08T00:00:00Z",
    "end": "2026-03-10T00:00:00Z",
    "days": 30
  },
  "merge_metrics": {
    "median_hours": 4.2,
    "p90_hours": 24.5,
    "count": 45
  },
  "authors": [
    {
      "author": "alice",
      "prs": 12,
      "merged": 10,
      "issues_flagged": 8,
      "avg_confidence": 4.2
    }
  ],
  "verdicts": {
    "APPROVE": 30,
    "REQUEST_CHANGES": 12,
    "NEEDS_DISCUSSION": 3
  },
  "confidence_dist": {
    "1": 0,
    "2": 2,
    "3": 8,
    "4": 20,
    "5": 15
  },
  "issue_categories": {
    "critical": 5,
    "moderate": 18,
    "minor": 32
  },
  "repos": [
    {
      "repo": "myorg/backend",
      "prs": 28,
      "merged": 24,
      "issues_flagged": 35
    }
  ],
  "pr_size": {
    "median": 145,
    "p90": 580
  }
}

Use Cases

• Team Performance: Track merge times and author productivity
• Quality Metrics: Monitor AI review verdicts and issue severity
• Process Optimization: Identify bottlenecks in PR review process
• Repository Health: Compare activity and quality across repositories

Related Endpoints

Summary Analytics

High-level metrics overview

Contributors

Detailed contributor profiles from AI memory