List Late Fine Settings | SalaryBox

{
  "message": "Success",
  "status": true,
  "data": [
    {
      "salarybox_id": "SBK7Q2M9TX",
      "employee_id": "EMP-0042",
      "name": "Aarav Sharma",
      "branches": [
        "Bengaluru HQ"
      ],
      "departments": [
        "Sales"
      ],
      "config": {
        "fine_type": "daily",
        "amount_type": "custom",
        "fine_amount": "100.00",
        "grace_period": "00:15:00",
        "waive_off_days": 2
      }
    },
    {
      "salarybox_id": "SBP8D4N6WE",
      "employee_id": "EMP-0057",
      "name": "Priya Nair",
      "branches": [
        "Bengaluru HQ"
      ],
      "departments": [
        "Customer Support"
      ],
      "config": {
        "fine_type": "hourly",
        "amount_type": "multipler",
        "fine_amount": "1.00",
        "grace_period": "00:10:00",
        "waive_off_days": 0
      }
    },
    {
      "salarybox_id": "SBR4T8W2PL",
      "employee_id": "EMP-0063",
      "name": "Rohan Verma",
      "branches": [
        "Pune Plant"
      ],
      "departments": [],
      "config": null
    }
  ],
  "count": 3,
  "prev": null,
  "next": null
}

Returns each staff member’s late arrival fine: the amount, grace period and number of late days forgiven each month. Requires Payroll Pro. config is null when no fine is set up, and then nothing is deducted.

A day is fined only when the person is later than grace_period; the whole late time is then fined.
The first waive_off_days late days in a month are forgiven.
fine_type is daily (per late day) or hourly (per hour late). amount_type is custom (fine_amount is money) or multipler (fine_amount is a multiple of the staff member’s daily or hourly salary, for example 0.50 for half a day’s pay).

These are the settings. For fines actually deducted, use List Salary Breakdowns.

Authentication

AuthorizationApi-Key

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

Query parameters

salarybox_idslist of stringsOptional

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

pageintegerOptional

Page number, starting at 1.

page_sizeintegerOptional

Results per page. Default and maximum 50.

Response

One row 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

403

Forbidden Error

404

Not Found Error