Fetch Single Record API

This API will display the record of a specific form indexed using a Record ID.

Request URL:

https://people.zoho.com/api/forms/employee/getDataByID?recordId=759415000000240001

Header:

Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxx9be93.9b8xxxxxxf

Scope:

ZOHOPEOPLE.forms.READ

Possible Operation Types:

READ - Read form data

Request Parameters:

PARAMETERS	VALUES ALLOWED	DEFAULT VALUE	PARAMETER DESCRIPTION	MANDATORY
formLinkName		-	To get formLinkName, refer appendix page.	Yes
recordId		-	Specifies the record Id of the record being fetched. The record Id can be identified using the bulk records API.	Yes

Error Codes and Descriptions

ERROR CODE	ERROR DESCRIPTION
7049	No record available with the specified record ID
7011	Form name <formLinkName> is invalid

Threshold Limit: 400 requests | Lock period: 5 minutes

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

Sample Request

Copiedhttps://people.zoho.com/api/forms/employee/getDataByID?recordId=759415000000240001

Sample Response

Copied{
    "response": {
        "result": [
            {
                "EmailID": "johndoe@example.com",
                "Gender": "Male",
                "ModifiedBy": "Jane Doe",
                "ApprovalStatus": "Approval Not Enabled",
                "total_experience.displayValue": "5 year(s) 4 month(s)",
                "Employeestatus": "Active",
                "Role.ID": "759415000000035631",
                "total_experience": "64",
                "Dateofjoining": "21-Jan-2020",
                "FirstName": "John",
                "ModifiedBy.ID": "759415000000240001",
                 "Photo_downloadUrl": "https://people.zoho.com/api/viewEmployeePhoto?filename=7470736000000141001",
                "AddedTime": "19-Jun-2023 12:43:59",
                "tabularSections": {
                    "Work experience": [
                        {
                            "Jobtitle": "Marketing",
                            "Employer": "",
                            "RELEVANCE": "",
                            "Previous_JobDesc": "",
                            "FromDate": "",
                            "Todate": "",
                            "RELEVANCE.id": ""
                        }
                    ]
                },
                "Permanent_Address.childValues": {
                    "CITY": "",
                    "COUNTRY": "xxx",
                    "STATE": "",
                    "ADDRESS1": "123 Example Street,
                    "PINCODE": "123456",
                    "ADDRESS2": "",
                    "STATE_CODE": "XX-ABC",
                    "COUNTRY_CODE": "XX"
                },
                "AddedBy": "Jane Doe",
                "Role": "Admin",
                "AddedBy.ID": "759415000000240001",
                "EmployeeID": "HRM02",
                "ModifiedTime": "25-Apr-2025 13:13:45",
            }
        ],
        "message": "Data fetched successfully",
        "uri": "/api/forms/employee/getDataByID",
        "status": 0
    }
}

Show full

Show less

Java JavaScript Curl Deluge Python

CopiedOkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
Request request = new Request.Builder()
  .url("https://people.zoho.com/api/forms/employee/getDataByID?recordId=759415000000240001")
  .get()
  .addHeader("Authorization", "••••••")
  .addHeader("Cookie", "CSRF_TOKEN=790891fd-6d6f-40fd-8381-8e81176e2d2f; _zcsr_tmp=790891fd-6d6f-40fd-8381-8e81176e2d2f; _zpsid=C9B0C2739FAE8B31975D2F7745237EFA; zalb_c7cb34e6ac=15579241ea20d8d7fa5eb5f3fb79c37a")
  .build();
Response response = client.newCall(request).execute();

Copiedconst myHeaders = new Headers();
myHeaders.append("Authorization", "••••••");
myHeaders.append("Cookie", "CSRF_TOKEN=790891fd-6d6f-40fd-8381-8e81176e2d2f; _zcsr_tmp=790891fd-6d6f-40fd-8381-8e81176e2d2f; _zpsid=C9B0C2739FAE8B31975D2F7745237EFA; zalb_c7cb34e6ac=15579241ea20d8d7fa5eb5f3fb79c37a");

const requestOptions = {
  method: "GET",
  headers: myHeaders,
  redirect: "follow"
};

fetch("https://people.zoho.com/api/forms/employee/getDataByID?recordId=759415000000240001", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

Copiedcurl --location 'https://people.zoho.com/api/forms/employee/getDataByID?recordId=759415000000240001' \
--header 'Authorization: ••••••' \
--header 'Cookie: CSRF_TOKEN=790891fd-6d6f-40fd-8381-8e81176e2d2f; _zcsr_tmp=790891fd-6d6f-40fd-8381-8e81176e2d2f; _zpsid=C9B0C2739FAE8B31975D2F7745237EFA; zalb_c7cb34e6ac=15579241ea20d8d7fa5eb5f3fb79c37a'

CopiedinputMap = Map();
inputMap.put("recordId","759415000000240001");
AuthMap = Collection();
AuthMap.insert("Authorization":"••••••");

response = invokeUrl
[
 	url: "https://people.zoho.com/api/forms/employee/getDataByID"
 	type: GET
 	parameters: inputMap
 	headers: AuthMap.toMap()
];
info response;

Copiedimport requests

url = "https://people.zoho.com/api/forms/employee/getDataByID?recordId=759415000000240001"

payload = {}
headers = {
  'Authorization': '••••••',
  'Cookie': 'CSRF_TOKEN=790891fd-6d6f-40fd-8381-8e81176e2d2f; _zcsr_tmp=790891fd-6d6f-40fd-8381-8e81176e2d2f; _zpsid=C9B0C2739FAE8B31975D2F7745237EFA; zalb_c7cb34e6ac=15579241ea20d8d7fa5eb5f3fb79c37a'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

Show full

Show less