Capacity

Query team workload, utilization metrics, and member availability for scheduling decisions.

Overview

The capacity endpoint returns workload and utilization data for your team. Use it to power dashboards, make routing decisions, or surface load balancing information.

GET /capacity?startDate={ISO}&endDate={ISO}

Required: startDate, endDate. Optional: teamId.

Response

{
  "success": true,
  "capacity": {
    "overview": {
      "totalMembers": 3,
      "activeMembers": 2,
      "averageUtilization": 0.45,
      "totalBookings": 12,
      "availableSlots": 36
    },
    "members": [
      {
        "id": "mem_01abc",
        "name": "Alex Rivera",
        "email": "alex@example.com",
        "teams": { "id": "team_01", "name": "Sales" },
        "capacity": {
          "maxBookingsPerDay": 8,
          "maxBookingsInRange": 40,
          "currentBookings": 12,
          "utilization": 0.3,
          "availableSlots": 28
        },
        "workload": {
          "totalHours": 40,
          "bookedHours": 6,
          "availableHours": 34
        },
        "bookingsByStatus": {
          "scheduled": 12,
          "completed": 8,
          "cancelled": 2,
          "noShow": 0,
          "rescheduled": 1
        }
      }
    ],
    "timeline": [
      {
        "date": "2026-05-01",
        "totalBookings": 3,
        "scheduledBookings": 2,
        "utilization": 0.6,
        "availableSlots": 5
      }
    ]
  },
  "dateRange": {
    "start": "2026-05-01T00:00:00.000Z",
    "end": "2026-05-07T00:00:00.000Z",
    "groupBy": "day"
  }
}

Fields

Field	Description
`capacity.overview.averageUtilization`	`0.0` – `1.0`. Average utilization across all members.
`capacity.members[].capacity.utilization`	`0.0` – `1.0`. Ratio of current bookings to max bookings in range.
`capacity.members[].capacity.availableSlots`	Remaining bookable slots for this member.
`capacity.members[].workload.bookedHours`	Total hours booked in the date range.

Use cases

Prevent overloading a member: filter members where capacity.utilization < 0.8 before offering assignTo options.

Surface availability: show capacity.availableSlots as remaining slots in your booking UI.

Team health dashboards: track utilization over timeline to identify burn-out risk or under-utilization.

Capacity

Overview

Response

Fields

Use cases

On this page