# Staff attendance

Record staff check-in/out and maintain an administrative daily and monthly register.

Category: People
Guide: https://avkul.in/docs/guides/module-staff-attendance/
Guided sample demo: https://avkul.in/docs/demo/module-staff-attendance/
Snapshot: 11 October 2026

## Features

- Own attendance
- Check-in/out
- Daily roster
- Corrections
- Monthly register
- Holiday marking

## 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: hr:view, hr:update, hr:manage

## Workflow

1. Check the current personal attendance state.
2. Clock in or out through the self-service action.
3. Use the authorized daily roster to correct records.
4. Review the monthly register and holiday policy.

## Fields and controls

- lat (number, optional)
- lng (number, optional)
- remark (string, optional)
- date (string, declared required)
- records (StaffAttendanceInput[], declared required)
- force (boolean, optional)
- from (string, declared required)
- to (string, declared required)

## Current limits

- Self-service acts on the caller’s staff profile. Administrative corrections need separate access.

## Actual application access

- https://avkul.in/en/school/staff-attendance

## API reference

- GET /api/v1/staff-attendance/me — The caller's own attendance history and check-in state; Authenticated scope
- POST /api/v1/staff-attendance/me/check-in — Clock in for today; Authenticated scope
- POST /api/v1/staff-attendance/me/check-out — Clock out for today; Authenticated scope
- GET /api/v1/staff-attendance/roster — All staff with their status for a date; hr:view
- POST /api/v1/staff-attendance/mark — Mark/correct staff attendance for a date; hr:update
- GET /api/v1/staff-attendance/register — Monthly staff attendance register; hr:view
- POST /api/v1/staff-attendance/mark-holidays — Stamp HOLIDAY rows for staff-applicable closed days; hr:manage

## 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.
