​
Pull Request Metrics

Pull request metrics provide insights into the volume, size, productivity, and interactions of pull requests in your repositories.

​
Available Metrics

​
pull-requests-count
string

Number of pull requests

​
pull-requests-size
string

Size of pull requests (typically measured in lines of code)

​
review-rate
string

Review rate (percentage of PRs that receive reviews)

​
productivity-score
string

Code productivity score

​
review-interactions-count
string

Number of review interactions

​
comment-interactions-count
string

Comment interaction count

​
comments-count
string

Number of comments

​
commit-interactions-count
string

Commit interaction count

​
commits-count
string

Number of commits

​
Pull Requests Count Metric

This endpoint provides the count of pull requests based on specified filters.

curl -X POST 'https://api.bilanc.co/metrics/v2/pull-requests-count' \
  -H 'Authorization: Bearer YOUR_AUTH_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "filters": {
      "pr_states": ["merged", "closed"],
      "start_date": "2023-01-01",
      "end_date": "2023-01-02"
    },
    "group_by": ["repository", "pr_state"],
    "date_level": "day",
    "date_field": "created_at",
  }'

​
Pull Requests Size Metric

This endpoint provides information about the size of pull requests.

curl -X POST 'https://api.bilanc.co/metrics/v2/pull-requests-size' \
  -H 'Authorization: Bearer YOUR_AUTH_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "filters": {
      "start_date": "2023-01-01",
      "end_date": "2023-12-31"
    },
    "group_by": ["repository"],
    "aggregation": "sum",
    "date_field": "created_at"
  }'

​
productivity Score Metric

This endpoint provides a productivity score for pull requests.

curl -X POST 'https://api.bilanc.co/metrics/v2/productivity-score' \
  -H 'Authorization: Bearer YOUR_AUTH_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "filters": {
      "team_ids": ["team123"],
      "start_date": "2023-01-02",
      "end_date": "2023-01-31"
    },
    "date_level": "week",
    "aggregation": "sum",
    "date_field": "created_at",
  }'

​
Parameter Notes

​
date_field
string

For pull request metrics, the following date fields are available:

  • created_at: When the PR was created
  • merged_at: When the PR was merged
  • closed_at: When the PR was closed
​
aggregation
string

Metrics that are not count based can be aggregated using the following method:

  • sum, max, min, avg

​
Common Use Cases

  • Monitor PR Volume: Track the number of PRs created over time
  • Identify Large PRs: Find PRs that are above a certain size threshold using metric_min_value
  • Analyze Review Culture: Track review rate and comments per PR
  • Assess productivity Trends: Monitor if code productivity is increasing or decreasing over time
  • Team Comparison: Compare PR metrics across different teams or repositories