Skip to main content
Use the analytics endpoints to pull code review metrics into your own dashboards or reports. All three endpoints require a valid Firebase ID Token and return JSON. The dashboard endpoints aggregate data across every repo connected to your account, while the per-repo endpoint provides a granular daily breakdown for a single repository.

GET /api/v1/repos/dashboard/analytics

Returns aggregated analytics across all repositories, including daily breakdowns of bugs caught and resolved per repo. Use this endpoint to power trend charts and cross-repo comparisons. Authentication required: Yes

Response

integer
Total number of issues raised by BugViper across all repositories and all time.
integer
Total number of issues that have been marked as resolved or fixed across all repositories.
number
Percentage of raised issues that were subsequently addressed, expressed as a decimal between 0 and 1 (e.g., 0.72 for 72%).
number
Rolling average number of pull requests reviewed per week across all repos.
number
Average time in hours from PR open to merge, calculated across all merged PRs.
array
Array of per-repo daily activity objects. Each entry includes the repo identifier, a date string, a count of bugs caught on that date, and a count of issues resolved on that date.

GET /api/v1/repos/dashboard/stats

Returns the summary statistics that populate the stat cards at the top of the BugViper dashboard. This is a lightweight endpoint designed for quick summary renders. Authentication required: Yes

Response

integer
Number of repositories currently connected to your BugViper account.
integer
Total number of distinct pull requests that have received at least one BugViper review.
integer
Total number of individual review runs executed across all repos and PRs.
integer
Total number of issues raised by BugViper across all reviews.
number
Percentage of raised issues that were addressed, expressed as a decimal between 0 and 1.
number
Rolling average number of pull requests reviewed per week.
number
Average time in hours from PR open to merge across all merged PRs.

GET /api/v1/repos/{owner}/{repo}/analytics

Returns detailed analytics for a single repository, including a daily breakdown of bugs caught and resolved, addressed rate, average merge time, and PRs-per-week figures. Use this endpoint to render the per-repo analytics view. Authentication required: Yes

Path Parameters

string
required
GitHub organization name or username that owns the repository.
string
required
Repository name.

Response

integer
Total number of issues BugViper has raised across all PRs in this repository.
integer
Number of those issues that have been marked as resolved or fixed.
number
Percentage of raised issues that were addressed, expressed as a decimal between 0 and 1.
number
Average time in hours from PR open to merge for this repository.
number
Rolling average number of pull requests reviewed per week in this repository.
array
Array of daily activity objects covering the selected date range.