Hierarchy Aggregation Service

Aggregate activity metrics for a unit within a date range

{
  "data": [
    {
      "unit_id": "unit-002",
      "unit_name": "Oslo Chapter",
      "total_activities": 87,
      "completed": 72,
      "in_progress": 10,
      "cancelled": 5,
      "date_from": "2026-01-01",
      "date_to": "2026-03-31"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1
  }
}

Count all activities across descendant units

{
  "unit_id": "unit-001",
  "descendant_activity_count": 342,
  "descendant_unit_count": 8
}

Aggregate activities grouped by hierarchy level

{
  "data": [
    {
      "level_type": "chapter",
      "unit_id": "unit-002",
      "unit_name": "Oslo Chapter",
      "total_activities": 87,
      "completed": 72
    },
    {
      "level_type": "chapter",
      "unit_id": "unit-019",
      "unit_name": "Bergen Chapter",
      "total_activities": 54,
      "completed": 50
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 4
  }
}

Get the aggregation rollup path from unit to root

{
  "unit_id": "unit-002",
  "aggregation_path": [
    {
      "unit_id": "unit-002",
      "name": "Oslo Chapter",
      "level_type": "chapter",
      "depth": 1
    },
    {
      "unit_id": "unit-001",
      "name": "Northern Region",
      "level_type": "region",
      "depth": 0
    }
  ]
}

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}