# Hostel, rooms & roll call

Manage residence capacity, room/bed allocations, visitor logs and nightly attendance.

Category: Campus
Guide: https://avkul.in/docs/guides/module-hostel/
Guided sample demo: https://avkul.in/docs/demo/module-hostel/
Snapshot: 11 October 2026

## Features

- Hostels and rooms
- Beds
- Resident allocations
- Visitor check-in/out
- Night roll call
- Missing residents

## Access and setup

Intended access: Assigned account with the required permissions
- An assigned school account with the required permissions.
- The academic, student or staff setup used by this workflow.

Permission keys: hostel:view, hostel:create, hostel:update, hostel:delete

## Workflow

1. Set up the hostel, rooms and beds.
2. Allocate eligible residents to available accommodation.
3. Record and check out permitted visitors.
4. Open the roll call, mark residents and close the register.

## Fields and controls

- name (string, declared required)
- type (string, optional)
- wardenStaffId (string, optional)
- address (string, optional)
- hostelId (string, declared required)
- roomNo (string, declared required)
- floor (string, optional)
- capacity (number, optional)
- fare (number, optional)
- roomId (string, declared required)
- bedNo (string, declared required)
- studentId (string, optional)
- bedId (string, declared required)
- fromDate (string, declared required)
- toDate (string, optional)
- visitorName (string, declared required)
- purpose (string, optional)
- idProof (string, optional)
- outTime (string, optional)
- date (string, optional)
- marks (ResidentMarkDto[], declared required)
- force (boolean, optional)
- notes (string, optional)

## Current limits

- Capacity and allocation state must be reviewed before assignment. Family notification delivery depends on the available channel.

## Actual application access

- https://avkul.in/en/school/hostel

## API reference

- GET /api/v1/hostel/stats — Get Stats; hostel:view
- GET /api/v1/hostel/my-allocation — My Allocation; Authenticated scope
- GET /api/v1/hostel/hostels — List Hostels; hostel:view
- POST /api/v1/hostel/hostels — Create Hostel; hostel:create
- PATCH /api/v1/hostel/hostels/:id — Update Hostel; hostel:update
- DELETE /api/v1/hostel/hostels/:id — Remove Hostel; hostel:delete
- GET /api/v1/hostel/rooms — List Rooms; hostel:view
- POST /api/v1/hostel/rooms — Create Room; hostel:create
- PATCH /api/v1/hostel/rooms/:id — Update Room; hostel:update
- DELETE /api/v1/hostel/rooms/:id — Remove Room; hostel:delete
- GET /api/v1/hostel/beds — List Beds; hostel:view
- POST /api/v1/hostel/beds — Create Bed; hostel:create
- PATCH /api/v1/hostel/beds/:id — Update Bed; hostel:update
- DELETE /api/v1/hostel/beds/:id — Remove Bed; hostel:delete
- GET /api/v1/hostel/allocations — List Allocations; hostel:view
- POST /api/v1/hostel/allocations — Create Allocation; hostel:create
- PATCH /api/v1/hostel/allocations/:id — Update Allocation; hostel:update
- POST /api/v1/hostel/allocations/:id/vacate — Vacate Allocation; hostel:update
- GET /api/v1/hostel/visitor-logs — List Visitor Logs; hostel:view
- POST /api/v1/hostel/visitor-logs — Create Visitor Log; hostel:create
- PATCH /api/v1/hostel/visitor-logs/:id — Update Visitor Log; hostel:update
- POST /api/v1/hostel/visitor-logs/:id/checkout — Checkout Visitor; hostel:update
- DELETE /api/v1/hostel/visitor-logs/:id — Remove Visitor Log; hostel:delete
- GET /api/v1/hostel/roll-call/missing — Residents not accounted for, and hostels with no roll call at all; hostel:view
- GET /api/v1/hostel/roll-call/:id — Register; hostel:view
- POST /api/v1/hostel/roll-call/open — Open tonight's register for a hostel; hostel:update
- POST /api/v1/hostel/roll-call/:id/mark — Mark; hostel:update
- POST /api/v1/hostel/roll-call/:id/close — Close the night; families of absent residents are told; hostel:update

## Demo access

No login is required for the guided sample demo. Its fictional records and actions stay in this browser tab; they do not modify ERP records or send messages/payments. An assigned account is required for the actual ERP links.

Source inventory checked on 11 October 2026. This source inventory is not a certification of every external provider or device flow.