Fetch Revisions by ERECNO API

This API is used to fetch a single employee salary revision.

Request URL:

https://people.zoho.com/api/compensation/v1/revisions/<erecno>

Header:

Authorization:Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf

Request Method:

GET

Scope:

ZohoPeople.compensation.ALL

Request Parameters:

erecno:
(mandatory)
Specify erecno of an employee whose record is to be fetched

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:

Copiedhttps://people.zoho.com/api/compensation/v1/revisions/100002000000038276

Sample Response:

CopiedResponse:
{
 "response": {
 "result": [
 {
 "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": "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": "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": "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/148113000000340003",
 "status": 0
 }
}