User Flows / Time & Attendance / Punches

Punch Recording

Capture clock-in/out events from any device

Overview

A "punch" is a timestamped record of an employee starting or ending their work. You can record punches from mobile apps, web kiosks, or biometric devices.

1. Record a Punch

Submit a new punch with geolocation and device info.

POST/api/v1/time-and-attendance/punches
Request Body
{
  "employeeId": "emp-123",
  "timestamp": "2024-05-20T09:05:00Z",
  "type": "CHECK_IN",
  "location": {
    "lat": 19.4326,
    "lng": -99.1332
  },
  "deviceId": "kiosk-reception"
}

2. Get History

Review punches to calculate total worked hours.

GET/api/v1/time-and-attendance/punches