​
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 provides benchmark data for various metrics.

curl -X POST 'https://api.bilanc.co/metrics/v2/benchmark' \
  -H 'Authorization: Bearer YOUR_AUTH_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "filters": {
      "industry": "software",
      "company_size": "medium",
      "metric_type": "cycle-time"
    },
    "group_by": ["metric_name"],
    "date_level": "total"
  }'

​
Industry Comparison

This endpoint allows you to compare your metrics with specific industry segments.

curl -X POST 'https://api.bilanc.co/metrics/v2/benchmark' \
  -H 'Authorization: Bearer YOUR_AUTH_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "filters": {
      "metric_type": "pull-requests-size",
      "company_size": "medium"
    },
    "group_by": ["industry"],
    "date_level": "total"
  }'

​
Parameter Notes

​
filters
object

Benchmark-specific filters:

  • industry: Filter by industry sector (software, finance, healthcare, etc.)
  • company_size: Filter by company size (small, medium, large, enterprise)
  • metric_type: The type of metric to benchmark
  • region: Filter by geographic region (optional)
  • year: Filter by benchmark year (optional)
​
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