Introduction

The WorkComposer Attendance API allows you to access and manage attendance data for your team members. Use these endpoints to retrieve clock-in/clock-out records, track work hours, and monitor attendance patterns across your organization.

This API is particularly useful for integrating WorkComposer's attendance tracking with your HR systems, payroll software, or custom reporting tools.

The Attendance Report endpoint provides detailed clock-in and clock-out records for all users in your workspace. This data includes the start and end times of work sessions, break periods, and the total duration of each activity.

{
  "status": 1,
  "totalCount": 2,
  "data": [
    {
      "user": {
        "id": "5be0b0b693be911e427b628f",
        "externalId": "123"
      },
      "clockInOut": [
        {
          "activity": "work",
          "start": "2022-08-03T01:51:00+04:00",
          "end": "2022-08-03T01:54:00+04:00",
          "duration": "00:03:41"
        },
        {
          "activity": "work",
          "start": "2022-08-03T02:27:00+04:00",
          "end": "2022-08-03T02:29:00+04:00",
          "duration": "00:02:26"
        }
      ]
    },
    {
      "user": {
        "id": "5d2f694dd5f2b56d18ad0c57",
        "externalId": "345"
      },
      "clockInOut": [
        {
          "activity": "work",
          "start": "2022-08-03T01:17:00+04:00",
          "end": "2022-08-03T01:19:00+04:00",
          "duration": "00:02:33"
        }
      ]
    }
  ]
}

        

The Daily Summary endpoint provides aggregated attendance data for each user, including total work hours, break time, and overtime for each day in the specified date range.

{
  "status": 1,
  "data": [
    {
      "user": {
        "id": "5be0b0b693be911e427b628f",
        "name": "John Smith",
        "email": "john@example.com"
      },
      "days": [
        {
          "date": "2022-08-01",
          "totalWorked": "07:45:12",
          "breakTime": "00:30:00",
          "overtime": "00:15:12",
          "firstClockIn": "09:00:23",
          "lastClockOut": "17:15:35"
        },
        {
          "date": "2022-08-02",
          "totalWorked": "08:12:45",
          "breakTime": "00:45:10",
          "overtime": "00:27:55",
          "firstClockIn": "08:45:12",
          "lastClockOut": "17:43:07"
        }
      ]
    }
  ]
}