Fetch Revisions API

This API is used to fetch the salary revisions of employees.

Request URL:

https://people.zoho.com/api/compensation/v1/revisions

Header:

Authorization:Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf

Request Method:

GET

Scope:

ZohoPeople.compensation.ALL

Request Parameters:

startIndex:	Starting index of the records to be fetched (record index starts from 1)
fromDate:	From data is the modified or created time of a revision
toDate:	To data is the modified or created time of a revision
status:	Specify approval status of a revision (value=pending/processed/rejected/cancelled)

Threshold Limit: 300 requests | Lock period: 5 minutes

Threshold Limit - Number of API calls allowed within a minute.
Lock Period - Wait time before consecutive API requests.

Error Codes & Responses

Sample Request:

Copied//people.zoho.com/api/compensation/v1/revisions

Sample Response:

Copied{
 "response": {
 "result": [
 {
 "Revision_Status": "Pending",
 "Modified_Time": "1723612218660",
 "Revised_Percentage": "3.00",
 "Reason_for_Revision": "Hike",
 "Revised_Amount": "2970.0",
 "Created_Time": "1723612218660",
 "Revised_CTC": "101970.0",
 "Approval_Status": "Pending",
 "Revised_CTC_Formatted": "AED 101970.0",
 "Salary_Package": "Entry Level",
 "Employee": "HRM2 VINDHYA SRI",
 "Effective_From": "14-Aug-2024",
 "Revision_Id": "148113000000370124",
 "Remarks": "",
 "Currency": "AED",
 "Erecno": "148113000000350001"
 },
 {
 "Revision_Status": "Processed",
 "Modified_Time": "1723612160891",
 "Revised_Percentage": "0.00",
 "Reason_for_Revision": "Initial Salary",
 "Revised_Amount": "0.0",
 "Created_Time": "1723612160891",
 "Revised_CTC": "45000.0",
 "Approval_Status": "Approved",
 "Revised_CTC_Formatted": "AED 45000.0",
 "Salary_Package": "Entry Level",
 "Employee": "1 Mrunal Thakur",
 "Effective_From": "19-Aug-2024",
 "Revision_Id": "148113000000370073",
 "Remarks": "",
 "Currency": "AED",
 "Erecno": "148113000000340003"
 },
 {
 "Revision_Status": "Cancelled",
 "Modified_Time": "1723612126983",
 "Revised_Percentage": "0.00",
 "Reason_for_Revision": "Initial Salary",
 "Revised_Amount": "0.0",
 "Created_Time": "1723601269339",
 "Revised_CTC": "90000.0",
 "Approval_Status": "Cancelled",
 "Revised_CTC_Formatted": "AED 90000.0",
 "Salary_Package": "Entry Level",
 "Employee": "1 Mrunal Thakur",
 "Effective_From": "20-Aug-2024",
 "Revision_Id": "148113000000366479",
 "Remarks": "",
 "Currency": "AED",
 "Erecno": "148113000000340003"
 },
 {
 "Revision_Status": "Cancelled",
 "Modified_Time": "1723601249761",
 "Revised_Percentage": "0.00",
 "Reason_for_Revision": "Initial Salary",
 "Revised_Amount": "0.0",
 "Created_Time": "1723601108480",
 "Revised_CTC": "9000.0",
 "Approval_Status": "Cancelled",
 "Revised_CTC_Formatted": "AED 9000.0",
 "Salary_Package": "Entry Level",
 "Employee": "1 Mrunal Thakur",
 "Effective_From": "04-Aug-2020",
 "Revision_Id": "148113000000366427",
 "Remarks": "",
 "Currency": "AED",
 "Erecno": "148113000000340003"
 },
 {
 "Revision_Status": "Cancelled",
 "Modified_Time": "1723601069675",
 "Revised_Percentage": "9.00",
 "Reason_for_Revision": "Hike",
 "Revised_Amount": "8910.0",
 "Created_Time": "1723571298529",
 "Revised_CTC": "107910.0",
 "Approval_Status": "Cancelled",
 "Revised_CTC_Formatted": "AED 107910.0",
 "Salary_Package": "Entry Level",
 "Employee": "HRM2 VINDHYA SRI",
 "Effective_From": "13-Aug-2024",
 "Revision_Id": "148113000000366183",
 "Remarks": "",
 "Currency": "AED",
 "Erecno": "148113000000350001"
 },
 {
 "Revision_Status": "Cancelled",
 "Modified_Time": "1723601091564",
 "Revised_Percentage": "0.00",
 "Reason_for_Revision": "Initial Salary",
 "Revised_Amount": "0.0",
 "Created_Time": "1723571069620",
 "Revised_CTC": "5000.0",
 "Approval_Status": "Cancelled",
 "Revised_CTC_Formatted": "AED 5000.0",
 "Salary_Package": "Entry Level",
 "Employee": "1 Mrunal Thakur",
 "Effective_From": "04-Aug-2020",
 "Revision_Id": "148113000000363715",
 "Remarks": "",
 "Currency": "AED",
 "Erecno": "148113000000340003"
 },
 {
 "Revision_Status": "Cancelled",
 "Modified_Time": "1723571049379",
 "Revised_Percentage": "0.00",
 "Reason_for_Revision": "Initial Salary",
 "Revised_Amount": "0.0",
 "Created_Time": "1723571026950",
 "Revised_CTC": "5000.0",
 "Approval_Status": "Cancelled",
 "Revised_CTC_Formatted": "AED 5000.0",
 "Salary_Package": "Entry Level",
 "Employee": "1 Mrunal Thakur",
 "Effective_From": "04-Aug-2020",
 "Revision_Id": "148113000000363649",
 "Remarks": "",
 "Currency": "AED",
 "Erecno": "148113000000340003"
 },
 {
 "Revision_Status": "Cancelled",
 "Modified_Time": "1723553527826",
 "Revised_Percentage": "0.00",
 "Reason_for_Revision": "Initial Salary",
 "Revised_Amount": "0.0",
 "Created_Time": "1723553470404",
 "Revised_CTC": "90000.0",
 "Approval_Status": "Cancelled",
 "Revised_CTC_Formatted": "AED 90000.0",
 "Salary_Package": "Entry Level",
 "Employee": "1 Mrunal Thakur",
 "Effective_From": "09-Aug-2024",
 "Revision_Id": "148113000000362075",
 "Remarks": "",
 "Currency": "AED",
 "Erecno": "148113000000340003"
 },
 {
 "Revision_Status": "Processed",
 "Modified_Time": "1723553269177",
 "Revised_Percentage": "0.00",
 "Reason_for_Revision": "Initial Salary",
 "Revised_Amount": "0.0",
 "Created_Time": "1723553269177",
 "Revised_CTC": "99000.0",
 "Approval_Status": "Approved",
 "Revised_CTC_Formatted": "AED 99000.0",
 "Salary_Package": "Entry Level",
 "Employee": "HRM2 VINDHYA SRI",
 "Effective_From": "04-Aug-2021",
 "Revision_Id": "148113000000363013",
 "Remarks": "",
 "Currency": "AED",
 "Erecno": "148113000000350001"
 },
 {
 "Revision_Status": "Cancelled",
 "Modified_Time": "1723553144488",
 "Revised_Percentage": "80.00",
 "Reason_for_Revision": "Hike",
 "Revised_Amount": "7200.0",
 "Created_Time": "1723209981635",
 "Revised_CTC": "16200.0",
 "Approval_Status": "Cancelled",
 "Revised_CTC_Formatted": "AED 16200.0",
 "Salary_Package": "Benefits and deduction",
 "Employee": "1 Mrunal Thakur",
 "Effective_From": "09-Aug-2024",
 "Revision_Id": "148113000000356001",
 "Remarks": "",
 "Currency": "AED",
 "Erecno": "148113000000340003"
 },
 {
 "Revision_Status": "Cancelled",
 "Modified_Time": "1723553252726",
 "Revised_Percentage": "0.00",
 "Reason_for_Revision": "Initial Salary",
 "Revised_Amount": "0.0",
 "Created_Time": "1723196176345",
 "Revised_CTC": "9000.0",
 "Approval_Status": "Cancelled",
 "Revised_CTC_Formatted": "AED 9000.0",
 "Salary_Package": "Entry Level",
 "Employee": "1 Mrunal Thakur",
 "Effective_From": "04-Aug-2020",
 "Revision_Id": "148113000000354091",
 "Remarks": "",
 "Currency": "AED",
 "Erecno": "148113000000340003"
 },
 {
 "Revision_Status": "Cancelled",
 "Modified_Time": "1723553153983",
 "Revised_Percentage": "0.00",
 "Reason_for_Revision": "Initial Salary",
 "Revised_Amount": "0.0",
 "Created_Time": "1723196111449",
 "Revised_CTC": "9000.0",
 "Approval_Status": "Cancelled",
 "Revised_CTC_Formatted": "AED 9000.0",
 "Salary_Package": "Entry Level",
 "Employee": "HRM2 VINDHYA SRI",
 "Effective_From": "04-Aug-2021",
 "Revision_Id": "148113000000354051",
 "Remarks": "",
 "Currency": "AED",
 "Erecno": "148113000000350001"
 },
 {
 "Revision_Status": "Cancelled",
 "Modified_Time": "1723196096396",
 "Revised_Percentage": "0.00",
 "Reason_for_Revision": "Initial Salary",
 "Revised_Amount": "0.0",
 "Created_Time": "1723181701094",
 "Revised_CTC": "4000.0",
 "Approval_Status": "Cancelled",
 "Revised_CTC_Formatted": "AED 4000.0",
 "Salary_Package": "Entry Level",
 "Employee": "HRM2 VINDHYA SRI",
 "Effective_From": "04-Aug-2021",
 "Revision_Id": "148113000000350038",
 "Remarks": "",
 "Currency": "AED",
 "Erecno": "148113000000350001"
 },
 {
 "Revision_Status": "Cancelled",
 "Modified_Time": "1723196040946",
 "Revised_Percentage": "8.00",
 "Reason_for_Revision": "Hike",
 "Revised_Amount": "4000.0",
 "Created_Time": "1722929125411",
 "Revised_CTC": "54000.0",
 "Approval_Status": "Cancelled",
 "Revised_CTC_Formatted": "AED 54000.0",
 "Salary_Package": "Benefits and deduction",
 "Employee": "1 Mrunal Thakur",
 "Effective_From": "03-Aug-2022",
 "Revision_Id": "148113000000346044",
 "Remarks": "",
 "Currency": "AED",
 "Erecno": "148113000000340003"
 },
 {
 "Revision_Status": "Cancelled",
 "Modified_Time": "1723196159456",
 "Revised_Percentage": "0.00",
 "Reason_for_Revision": "Initial Salary",
 "Revised_Amount": "0.0",
 "Created_Time": "1722923195720",
 "Revised_CTC": "50000.0",
 "Approval_Status": "Cancelled",
 "Revised_CTC_Formatted": "AED 50000.0",
 "Salary_Package": "Entry Level",
 "Employee": "1 Mrunal Thakur",
 "Effective_From": "04-Aug-2020",
 "Revision_Id": "148113000000342820",
 "Remarks": "",
 "Currency": "AED",
 "Erecno": "148113000000340003"
 }
 ],
 "message": "Success",
 "uri": "/api/compensation/v1/revisions",
 "status": 0
 }
}