Skip to main content

​
Issue Metrics

Issue metrics provide insights into ticket management, story points, and team productivity in handling issues.

​
Available Metrics

​
issues-count
string
Number of issues
​
completed-issues-count
string
Number of completed issues
​
started-issues-count
string
Number of started issues
​
backlog-issues-count
string
Number of backlog issues
​
story-points
string
Story points
​
completed-story-points
string
Completed story points
​
started-story-points
string
Started story points
​
issue-cycle-time
string
Issue cycle time
​
issue-comment-interactions-count
string
Issue comment interaction count
​
issue-comments-count
string
Number of issue comments

​
Completed Issues Count Metric

This endpoint provides the count of completed issues based on specified filters. 
curl -X POST 'https://api.bilanc.co/metrics/completed-issues-count' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "filters": {
      "team": ["team123"],
      "start_date": "2023-01-01",
      "end_date": "2023-12-31"
    },
    "group_by": ["team_name", "name"],
    "date_level": "month",
    "date_field": "completed_at",
    "time_series_data": true
  }'

​
Story Points Metric

This endpoint provides information about story points. 
curl -X POST 'https://api.bilanc.co/metrics/story-points' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "filters": {
      "team": ["team123"],
      "start_date": "2023-01-01",
      "end_date": "2023-12-31"
    },
    "group_by": ["team_name"],
    "date_level": "quarter",
    "aggregation": "SUM",
    "date_field": "created_at"
  }'

​
Issue Cycle Time Metric

This endpoint provides data on issue cycle time (from creation to completion). 
curl -X POST 'https://api.bilanc.co/metrics/issue-cycle-time' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "filters": {
      "project_ids": ["project456"],
      "start_date": "2023-01-01",
      "end_date": "2023-12-31"
    },
    "group_by": ["issue_type"],
    "date_level": "month",
    "aggregation": "AVG",
    "date_field": "completed_at",
    "time_series_data": true
  }'

​
Parameter Notes

​
date_field
string
For issue metrics, the following date fields are available:
  • created_at: When the issue was created
  • started_at: When work on the issue started
  • completed_at: When the issue was completed
  • closed_at: When the issue was closed
​
aggregation
string
Required for story point and cycle time metrics. Accepted values: SUM, MAX, MIN, AVG. Count-based metrics (issues-count, completed-issues-count, started-issues-count, backlog-issues-count, issue-comment-interactions-count, issue-comments-count) do not require an aggregation.
​
filters
object
Applicable filters for issue metrics:
  • ticket_status: Filter by issue state — completed, started, backlog, etc.
  • issue_ids: Filter by specific issue IDs
  • project_ids: Filter by project IDs
  • team: Filter by team IDs
  • squad_ids: Filter by squad IDs
  • squad_levels: Filter by squad hierarchy level
  • manager_ids: Filter by manager user IDs
  • departments: Filter by department names
  • member: Filter by assignee/author merged user IDs
  • locations: Filter by employee location
  • levels: Filter by employee level

​
Common Use Cases

  • Sprint Velocity: Track completed story points per sprint
  • Ticket Resolution: Monitor the number of completed issues over time
  • Cycle Time Analysis: Identify bottlenecks in issue resolution
  • Backlog Management: Track the growth or reduction of backlog issues
  • Comment Analysis: Analyze communication patterns through issue comments
  • Team Performance: Compare team productivity based on issues completed and story points