key

Please contact the HRWorks administrator in your organization for the API key.

^{

^{"employeeId": "<Employee ID>",} 

^{"location": "<Swipe/Biometric machine ID>",} 

^{"swipeTime": "<yyyy-mm-dd hh:mm:ss>",} 

^{"in_out": "<In/Out>"}

^}

[{
"employeeId": "<Employee ID>", 
"location": "<Swipe/Biometric machine ID>", 
"swipeTime": "<yyyy-mm-dd hh:mm:ss>", 
"in_out": "<In/Out>"
},
...
]

employeeId

This is a text value specifying Employee Id of the employee swiping his card.

This is a mandatory field.

location

This is a text value specifying the ID for the swipe card / biometric machine. This should correspond to a swipe card / biometric machine ID (referred to as Attendance Location ID in HRWorks) stored in HRWorks.

This is a non-mandatory field. If a value is not provided, the default attendance location (as specified in HRWorks) shall be used.

swipeTime

Refers to the time of employee swiping his card/finger. This should be a date value as per the ISO8601 format.

Typical Formats: yyyy-mm-dd hh:mm:ss or yyyy-mm-ddThh:mm:ssZ .

Note:

• yyyy = year in 4 digits. For example, 2015.

• mm = month in 2 digits, from 01 (for January) to 12 (for December).

• dd = day of month in 2 digits, from 01 to 31.

• hh = hour in 2 digits, from 00 to 23.

• mm = minute in 2 digits from 00 to 59.

• ss = second in 2 digits from 00 to 59.

• T = Letter T can be inserted between yyyy-mm-dd and hh:mm:ss instead of space.

• Z = Letter Z refers to zero meridian and can be appended (optional) to hh:mm:ss.

The time format represents Coordinated Universal Time (UTC). For example, 2015-09-03 13:50:00 or 2015-09-03T13:50:00Z represents 01:50 p.m. (UTC) on September 09, 2015.

Time Zones:

The strings +hh:mm, +hhmm, -hh:mm, -hhmm can be appended to yyyy-mm-dd hh:mm:ss in order to specify a time zone relative to UTC. For example, UTC+5:30 represents Indian Standard Time (IST) and hence 2015-09-03 13:50:00+05:30 represents 01:50 p.m. (IST) on September 09, 2015.

Accepted date and time formats:

a. yyyy-mm-dd hh:mm:ss+hh:mm

b. yyyy-mm-dd hh:mm:ss+hhmm

c. yyyy-mm-dd hh:mm:ss-hh:mm

d. yyyy-mm-dd hh:mm:ss-hhmm

Note:

a. In all of the above, the space between yyyy-mm-dd and hh:mm:ss can be replaced with the letter T. For example, both 2015-09-30 12:00:00 and 2015-09-30T12:00:00 are acceptable.

b. In all of the above the letter Z can be appended to hh:mm:ss. Both hh:mm:ss and hh:mm:ssZ refer to time in UTC. For example, both 2015-09-30T12:00:00 and 2015-09-30T12:00:00Z refer to the same time in UTC .

This is a mandatory field.

in_out

This should be a text input with the value “In” or “Out”. In/Out signifies whether swipe machine was used for employee's entry or exit.

This is a mandatory field.

{
    "success": false,
    "statusCode": 400,
    "errorMsg": "Invalid JSON. Please ensure you are passing a valid JSON string and it is url encoded properly."
}

1
2
3
4
5

#The following command

uploads attendance employee data.
  
curl --location --request POST 'https://hinote.in/hrworks/api/post/AttendanceInput.do?key=<customer_api_key>\
--header 'Content-Type: text/plain' \
--data-raw '{"employeeId":

"1001", "location": "ChennaiOffice-MainEntrance", "swipeTime": "2025-08-03 10:05:00+05:30", "

in_out": "

In"}'