Fetch Single Record API (Section Wise)

This API will fetch all the record of a specific form indexed using a Record ID by section-wise.

Request URL:

https://people.zoho.com/api/forms/department/getRecordByID?recordId=759415000001314059

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

Common 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/department/getRecordByID?recordId=759415000001314059

Sample Response

Copied{
    "response": {
        "result": [
            {
                "Department Details": {
                    "Department_Code": "01",
                    "Department_Lead.MailID": "janedoe@example.com",
                    "AddedTime": "02-May-2025 13:08:29",
                    "Department_Lead": "Jane Doe",
                    "ModifiedBy": "Jane Doe",
                    "ModifiedBy.ID": "759415000000240001",
                    "Department": "Marketing",
                    "Department_Lead.ID": "759415000000240001",
                    "Parent_Department.ID": "759415000000240003",
                    "ModifiedTime": "27-May-2025 09:55:30",
                    "AddedBy.ID": "759415000000240001",
                    "Parent_Department": "HR",
                    "AddedBy": "Jane Doe",
                    "MailAlias": "marketing@example.com"
                },
                "ApprovalStatus": "Approval Not Enabled"
            }
        ],
        "message": "Data fetched successfully",
        "uri": "/api/forms/department/getRecordByID",
        "status": 0
    }
}

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/department/getRecordByID?recordId=759415000001314059")
  .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/department/getRecordByID?recordId=759415000001314059", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

Copiedcurl --location 'https://people.zoho.com/api/forms/department/getRecordByID?recordId=759415000001314059' \
--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","759415000001314059");
AuthMap = Collection();
AuthMap.insert("Authorization":"••••••");

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

Copiedimport requests

url = "https://people.zoho.com/api/forms/department/getRecordByID?recordId=759415000001314059"

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)