Benefit Calculator BLoC

List all calculator sessions (state snapshots per user/mentor)

{
  "data": [
    {
      "session_id": "session_c4b7e2d1",
      "mentor_id": "mentor_001",
      "state": "loaded",
      "last_event": "CalculateRequested",
      "result_id": "calc_7f3a2b1c",
      "created_at": "2026-03-26T09:00:00Z",
      "updated_at": "2026-03-26T09:15:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1
  }
}

Get a specific calculator session state snapshot

{
  "session_id": "session_c4b7e2d1",
  "mentor_id": "mentor_001",
  "state": "loaded",
  "last_event": "CalculateRequested",
  "result_id": "calc_7f3a2b1c",
  "created_at": "2026-03-26T09:00:00Z",
  "updated_at": "2026-03-26T09:15:00Z"
}

Initialise a new calculator session for a mentor

{
  "mentor_id": "mentor_001",
  "organisation_id": "org_42"
}

{
  "session_id": "session_e9a3f1c8",
  "mentor_id": "mentor_001",
  "state": "initial",
  "last_event": null,
  "result_id": null,
  "created_at": "2026-03-26T09:00:00Z",
  "updated_at": "2026-03-26T09:00:00Z"
}

Dispatch an event to the BLoC session (e.g. CalculateRequested, ShareRequested)

{
  "event": "CalculateRequested",
  "payload": {
    "sessions": 25,
    "avg_minutes": 30,
    "cost_per_session": 3.5,
    "cost_per_hour": 30
  }
}

{
  "session_id": "session_e9a3f1c8",
  "mentor_id": "mentor_001",
  "state": "loaded",
  "last_event": "CalculateRequested",
  "result_id": "calc_9d1e4f2a",
  "created_at": "2026-03-26T09:00:00Z",
  "updated_at": "2026-03-26T09:15:00Z"
}

Close and discard a calculator session

{
  "deleted": true,
  "session_id": "session_c4b7e2d1"
}

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