---
title: "List Attendance"
method: POST
path: "/hr/attendance"
---

# List Attendance

`POST /hr/attendance`

This API functionality captures the checkin & checkout of an employee. This is used in HR-Reception to update the actual checkin /checkout time.

## Query parameters

- `date` string, date, required
- `type` string, required
- `pagination` object[], required
  - `perpage` string — Number of records to return per page
  - `page` string — Current page number to retrieve.
  - `query` string — Search employee name in the attendance record
- `sort` object[]
  - `field` string — Used to sort the column (eg:employee_name)
  - `sort` string — ASC for ascending and DESC for descending

## Headers

- `api-token` string
- `x-api-key` string

## Response `200`

200

- object
  - `status` integer
  - `msg` string
  - `data` object[]
    - `employee_id` string
    - `employee_name` string
    - `designation` string
    - `date` string
    - `shift` string
    - `intime` string
    - `instatus` string
    - `outtime` unknown
    - `outstatus` string
    - `checkin_image` string
    - `checkout_image` unknown
    - `bid` integer
    - `gid` integer
    - `personalnumber` integer
    - `availability` string
    - `branch_name` string
    - `branch` integer

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `500` — 500
- `501` — 501
- `502` — 502
- `503` — 503

---

[API](https://skmtc.dev/ledgers/apis/authentication.md) · [All operations](https://skmtc.dev/ledgers/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ledgers/authentication/revisions/605f28ef08ef/schema)