List Attendance Timesheets | SalaryBox

{
  "message": "Success",
  "status": true,
  "data": [
    {
      "salarybox_id": "SBK7Q2M9TX",
      "employee_id": "EMP-0042",
      "name": "Aarav Sharma",
      "branches": [
        "Bengaluru HQ"
      ],
      "departments": [
        "Sales"
      ],
      "timezone": "Asia/Kolkata",
      "summary": {
        "absent": 0,
        "present": 1,
        "double_present": 0,
        "half_day": 0,
        "week_off": 0,
        "holiday": 0,
        "paid_leave": 0,
        "unpaid_leave": 0,
        "half_day_leave": 0,
        "late": 1,
        "early": 0,
        "overtime": 1
      },
      "days": [
        {
          "date": "2026-11-05",
          "status": "present",
          "status_label": "Present",
          "leave_name": null,
          "is_half_day_leave": false,
          "shifts": [
            {
              "name": "General Shift",
              "start_time": "09:30:00",
              "end_time": "18:30:00"
            }
          ],
          "first_in": "2026-11-05T09:42:10+05:30",
          "last_out": "2026-11-05T19:45:00+05:30",
          "last_punch_type": "OUT",
          "last_punch_time": "2026-11-05T19:45:00+05:30",
          "punch_count": 4,
          "assigned_shift_hours": "9.00",
          "hours_worked": "9.55",
          "overtime_hours": "0.55",
          "late_arrival_hours": "0.20",
          "early_leaving_hours": "0.00",
          "is_late": true,
          "is_early_leaving": false,
          "has_overtime": true
        }
      ]
    },
    {
      "salarybox_id": "SBP8D4N6WE",
      "employee_id": "EMP-0057",
      "name": "Priya Nair",
      "branches": [
        "Bengaluru HQ"
      ],
      "departments": [
        "Customer Support"
      ],
      "timezone": "Asia/Kolkata",
      "summary": {
        "absent": 0,
        "present": 1,
        "double_present": 0,
        "half_day": 0,
        "week_off": 0,
        "holiday": 0,
        "paid_leave": 0,
        "unpaid_leave": 0,
        "half_day_leave": 0,
        "late": 1,
        "early": 0,
        "overtime": 0
      },
      "days": [
        {
          "date": "2026-11-05",
          "status": "present",
          "status_label": "Present",
          "leave_name": null,
          "is_half_day_leave": false,
          "shifts": [
            {
              "name": "Support Shift",
              "start_time": "10:00:00",
              "end_time": "19:00:00"
            }
          ],
          "first_in": "2026-11-05T10:01:30+05:30",
          "last_out": null,
          "last_punch_type": "IN",
          "last_punch_time": "2026-11-05T10:01:30+05:30",
          "punch_count": 1,
          "assigned_shift_hours": "9.00",
          "hours_worked": "0.00",
          "overtime_hours": "0.00",
          "late_arrival_hours": "0.03",
          "early_leaving_hours": "0.00",
          "is_late": true,
          "is_early_leaving": false,
          "has_overtime": false
        }
      ]
    }
  ],
  "count": 2,
  "prev": null,
  "next": null
}

Returns one entry per staff member per day for up to 31 days: status, leave, shifts, first punch-in, last punch-out, hours worked, late arrival, early leaving and overtime, plus a summary for the range. The numbers match the staff timesheet in the app.

Every staff member gets an entry for every date, including dates before they joined and future dates.

Status values

`status`	Meaning
`present`	Marked present. Working on a week off or holiday also shows `present`.
`double_present`	Marked double present: counts as two days of attendance.
`half_day`	Marked half day.
`half_day_leave`	Half day, with a half-day leave applied.
`paid_leave`	On paid leave.
`unpaid_leave`	On unpaid leave.
`absent`	Marked absent, or nothing marked yet on a working day.
`week_off`	The staff member’s day off.
`holiday`	One of your company’s holidays.

Hours are strings with 2 decimals, for example 1 h 33 m is "1.55".

Unpaid breaks are not counted as hours worked; paid breaks are.
Late arrival and early leaving are measured from shift times, with no grace period.
Overtime is time worked beyond the day’s shift length (or the staff member’s minimum hours, if set), with no grace period. For overtime as payroll pays it, use Get Staff Overtime.

Night shifts. A punch-out after midnight belongs to the day the shift started.

Who is in right now? Call with today’s date and check last_punch_type: IN or BREAK_END means at work, BREAK_START on a break, OUT or null not at work.

Authentication

AuthorizationApi-Key

Format: “Api-Key {api-key}”

Query parameters

start_datedateRequired

First day, YYYY-MM-DD.

end_datedateRequired

Last day, YYYY-MM-DD. The range can cover at most 31 days. Use the same date as start_date for one day.

salarybox_idslist of stringsOptional

Repeatable. Limits the result to these staff members, for example salarybox_ids=SBK7Q2M9TX&salarybox_ids=SBK3H8D1LP.

branch_nameslist of stringsOptional

Repeatable. Exact branch names (case-sensitive).

department_nameslist of stringsOptional

Repeatable. Exact department names (case-sensitive).

pageintegerOptional

Page number, starting at 1.

page_sizeintegerOptional

Results per page. Default and maximum 500.

Response

One entry per matching staff member on this page.

messagestring

statusboolean

datalist of objects

countinteger

Total number of matching staff members across all pages.

prevstring or null

URL of the previous page, or null on the first page.

nextstring or null

URL of the next page, or null on the last page.

Errors

400

Bad Request Error

404

Not Found Error