Benchmark Metrics

API endpoints for comparing your metrics against industry benchmarks

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.

Request

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.

Request

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

Assistant

Responses are generated using AI and may contain mistakes.