Booking Demand

Returns booking volumes per day for a date range. Compare these against staffing levels to plan coverage.

Endpoint

GET /v1/staff/schedule/demand

Authentication

Requires an API key with the staff:read scope.

Query Parameters

Parameter	Type	Required	Description
start_date	string	Yes	Start of date range (YYYY-MM-DD)
end_date	string	Yes	End of date range (YYYY-MM-DD, must be ≥ start_date)

Response

Success (200 OK)

{
  "data": [
    {
      "date": "2026-04-07",
      "booking_count": 12,
      "participant_count": 28
    },
    {
      "date": "2026-04-08",
      "booking_count": 7,
      "participant_count": 14
    }
  ],
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-04-01T09:00:00+00:00"
  }
}

Errors

Status	Code	Description
401	authentication_required	No API key provided
401	invalid_api_key	Invalid API key
403	insufficient_scope	API key lacks staff:read scope
422	validation_error	Missing or invalid date fields

Example Request

curl -X GET "https://app.equipdash.com/api/v1/staff/schedule/demand?start_date=2026-04-07&end_date=2026-04-13" \
  -H "Authorization: Bearer eqd_live_abc123xyz789..."