Skip to main content

​
Benchmark Metrics

Benchmark metrics provide insights into how your engineering organization compares to industry standards and best practices.

​
Available Metrics

​
benchmark
string
Retrieves benchmark metrics for comparison

​
Benchmark Metric

This endpoint compares a given metric against anonymized data from all organizations on the platform. 
curl -X POST 'https://api.bilanc.co/metrics/benchmark' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "filters": {
      "start_date": "2023-01-01",
      "end_date": "2023-12-31"
    },
    "benchmark_metric": "cycle-time",
    "date_field": "merged_at"
  }'

​
PR Size Benchmark

Compare your organization’s pull request size against the platform benchmark. 
curl -X POST 'https://api.bilanc.co/metrics/benchmark' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "filters": {
      "start_date": "2023-01-01",
      "end_date": "2023-12-31"
    },
    "benchmark_metric": "pull-requests-size",
    "date_field": "merged_at"
  }'

​
Parameter Notes

​
benchmark_metric
string
required
The metric to benchmark (e.g. cycle-time, pull-requests-size, pickup-time). This is a top-level request body parameter, not a filter.
​
date_field
string
required
The date field to use for the benchmark query (e.g. merged_at, created_at).
​
filters
object
Standard date filters apply:
  • start_date: Start of the date range (required)
  • end_date: End of the date range (defaults to today)
​
benchmark_metadata
object
The response includes benchmark metadata:
  • benchmark_value: The median value for the benchmark group
  • benchmark_p25: The 25th percentile value
  • benchmark_p50: The 50th percentile value (median)
  • benchmark_p75: The 75th percentile value
  • percentile: Your organization’s percentile ranking

​
Common Use Cases

  • Performance Comparison: Compare your team’s performance against industry standards
  • Goal Setting: Set realistic goals based on industry benchmarks
  • Identifying Opportunities: Find areas where your team significantly underperforms compared to benchmarks
  • Executive Reporting: Provide context for metrics by showing where the organization stands relative to peers
  • Competitive Analysis: Understand how your engineering organization compares to competitors