Get Regularization Records API
This API is used for fetching multiple records of regularization requests raised within a given data range. Multiple regularization records can be fetched for all the employees in the organization or for a specific employee using this API
Request URL
https://people.zoho.com/people/api/attendance/getRegularizationRecords
Header:
Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxx9be93.9b8xxxxxxf
Request Parameters
| fromdate | Specify the start date |
| todate | Specify the end date |
| dateFormat | Specify the date format for the date given. Eg: yyyy-MM-dd |
| employeeId | Specify the employee ID of an employee (Optional Parameter) |
| startIndex | Specify the start index of the record |
| recordId | Record Id of Attendance Regularization |
Note:
- If record Id is available then no other parameter will be considered (even if provided). If record Id is not available then fromdate and todate become mandatory fields. If the dateFormat parameter is not provided, then the fromdate and todate should be in the format specified in company settings. If dateFormat is provided, then fromdate and todate should be in the date format of your choice as specified in the parameter.
- employeeId is used when records of a specific employee need to be fetched.
- startIndex - API will fetch a maximum of 200 records at a time. For fetching next sets of records, startIndex along with the starting number of the next set of records (e.g.201) should be used.
Threshold Limit: 30 requests | Lock period: 5 minutes
Threshold Limit - Number of API calls allowed within a minute.
Lock Period - Wait time before consecutive API requests.
Header
Copied{
"result": [
{
"recordId": "173907000000181100",
"approvalStatus": "Waiting for approval",
"regDetails": [
{
"date": "15-Oct-2018",
"newCheckOutTime": "04:50 PM",
"newAttStatus": "Present",
"newCheckInTime": "07:45 AM",
"regDetailsId": "173907000000111000",
"oldTotalHours": 0,
"newTotalHours": 32700,
"oldAttStatus": "Present",
"oldCheckInTime": "12:50 AM",
"indApprovalStatus": "Waiting for approval",
"oldCheckOutTime": "12:50 AM",
"desc": "Didn't bring Id card"
}
],
"employeeName": "Kumar",
"employeeErecno": "177402000000969127",
"employeeId": "1",
"startDate": "15-Oct-2018"
},
{
"recordId": "173907000000181106",
"approvalStatus": "Waiting for approval",
"regDetails": [
{
"date": "15-Oct-2018",
"newCheckOutTime": "06:00 PM",
"newAttStatus": "Present",
"newCheckInTime": "09:00 AM",
"regDetailsId": "173907000000111003",
"oldTotalHours": 0,
"newTotalHours": 32400,
"oldAttStatus": "Present",
"oldCheckInTime": "12:50 AM",
"indApprovalStatus": "Waiting for approval",
"oldCheckOutTime": "12:50 AM"
},
{
"date": "17-Oct-2018",
"newCheckOutTime": "07:00 PM",
"newAttStatus": "Present",
"newCheckInTime": "10:30 AM",
"regDetailsId": "173907000000111006",
"oldTotalHours": 0,
"newTotalHours": 30600,
"oldAttStatus": "Present",
"oldCheckInTime": "12:50 AM",
"indApprovalStatus": "Waiting for approval",
"oldCheckOutTime": "12:50 AM"
},
{
"date": "18-Oct-2018",
"newCheckOutTime": "01:00 PM",
"newAttStatus": "Present",
"newCheckInTime": "09:00 AM",
"regDetailsId": "1739070000001110009",
"oldTotalHours": 0,
"newTotalHours": 14400,
"oldAttStatus": "Present",
"oldCheckInTime": "12:50 AM",
"indApprovalStatus": "Waiting for approval",
"oldCheckOutTime": "12:50 AM"
}
],
"employeeName": "Kumar",
"employeeErecno": "177402000000969127",
"endDate": "20-Oct-2018",
"employeeId": "1",
"startDate": "14-Oct-2018"
}
],
"message": "Success",
"uri": "/api/attendance/getRegularizationRecords",
"status": 0
}Sample Response
Copied{
"result": [
{
"recordId": "173907000000181100",
"approvalStatus": "Waiting for approval",
"regDetails": [
{
"date": "15-Oct-2018",
"newCheckOutTime": "04:50 PM",
"newAttStatus": "Present",
"newCheckInTime": "07:45 AM",
"regDetailsId": "173907000000111000",
"oldTotalHours": 0,
"newTotalHours": 32700,
"oldAttStatus": "Present",
"oldCheckInTime": "12:50 AM",
"indApprovalStatus": "Waiting for approval",
"oldCheckOutTime": "12:50 AM",
"desc": "Didn't bring Id card"
}
],
"employeeName": "Kumar",
"employeeErecno": "177402000000969127",
"employeeId": "1",
"startDate": "15-Oct-2018"
},
{
"recordId": "173907000000181106",
"approvalStatus": "Waiting for approval",
"regDetails": [
{
"date": "15-Oct-2018",
"newCheckOutTime": "06:00 PM",
"newAttStatus": "Present",
"newCheckInTime": "09:00 AM",
"regDetailsId": "173907000000111003",
"oldTotalHours": 0,
"newTotalHours": 32400,
"oldAttStatus": "Present",
"oldCheckInTime": "12:50 AM",
"indApprovalStatus": "Waiting for approval",
"oldCheckOutTime": "12:50 AM"
},
{
"date": "17-Oct-2018",
"newCheckOutTime": "07:00 PM",
"newAttStatus": "Present",
"newCheckInTime": "10:30 AM",
"regDetailsId": "173907000000111006",
"oldTotalHours": 0,
"newTotalHours": 30600,
"oldAttStatus": "Present",
"oldCheckInTime": "12:50 AM",
"indApprovalStatus": "Waiting for approval",
"oldCheckOutTime": "12:50 AM"
},
{
"date": "18-Oct-2018",
"newCheckOutTime": "01:00 PM",
"newAttStatus": "Present",
"newCheckInTime": "09:00 AM",
"regDetailsId": "1739070000001110009",
"oldTotalHours": 0,
"newTotalHours": 14400,
"oldAttStatus": "Present",
"oldCheckInTime": "12:50 AM",
"indApprovalStatus": "Waiting for approval",
"oldCheckOutTime": "12:50 AM"
}
],
"employeeName": "Kumar",
"employeeErecno": "177402000000969127",
"endDate": "20-Oct-2018",
"employeeId": "1",
"startDate": "14-Oct-2018"
}
],
"message": "Success",
"uri": "/api/attendance/getRegularizationRecords",
"status": 0
}