Fetch Categories API
This API is used for fetching categories in LMS.
Request URL:
https://people.zoho.com/api/v1/categories
Scope:
ZOHOPEOPLE.training.ALL
OR
ZOHOPEOPLE.training.READ
Possible Operation Types:
ALL - Complete access to data
READ - Only to fetch data
Method:
GET
Request Parameters
| Parameters | Values Allowed | Default Value | Description |
| startIndex | <integer> | 0 | Specify from which record the response must be fetched |
Error Codes and Descriptions
| Status Codes | Description |
|---|---|
| 400 | Invalid parameter value/input parameter missing |
| 403 | Sorry! You are not authorized to do this operation |
| 404 | Not found |
| 422 | Maximum limit exceeded |
| 500 | Sorry! Server error occured |
View complete list of LMS API error codes
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.
Request
Copiedimport okhttp3.*;
public class Main {
public static void main(String[] args) throws Exception {
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://people.zoho.com/api/v1/categories")
.get()
.addHeader("Authorization", "Zoho-oauthtoken YOUR_ACCESS_TOKEN")
.build();
Response response = client.newCall(request).execute();
System.out.println(response.body().string());
}
}Copiedconst url = "https://people.zoho.com/api/v1/categories";
fetch(url, {
method: "GET",
headers: {
"Authorization": "Zoho-oauthtoken YOUR_ACCESS_TOKEN"
}
})
.then(response => response.json())
.then(result => console.log(result))
.catch(error => console.error("Error:", error));Copiedcurl -X GET "https://people.zoho.com/api/v1/categories" \
-H "Authorization: Zoho-oauthtoken YOUR_ACCESS_TOKEN"Copiedurl = "https://people.zoho.com/api/v1/categories";
headers = map();
headers.put("Authorization", "Zoho-oauthtoken YOUR_ACCESS_TOKEN");
response = invokeurl
[
url : url
type : GET
headers: headers
];
info response;Copiedimport requests
url = "https://people.zoho.com/api/v1/categories"
headers = {
"Authorization": "Zoho-oauthtoken YOUR_ACCESS_TOKEN"
}
response = requests.get(url, headers=headers)
print(response.text)Show full
Show less
Header
CopiedAuthorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxx9be93.9b8xxxxxxfResponse
Copied{
"code": "200",
"categories": [
{
"name": "Languages",
"isFavourite": false,
"categoryId": "219225000000171061"
},
{
"name": "Sales",
"isFavourite": false,
"categoryId": "219225000000171057"
},
{
"name": "Human Resources",
"isFavourite": false,
"categoryId": "219225000000171053"
},
{
"name": "E-commerce",
"isFavourite": false,
"categoryId": "219225000000171049"
},
{
"name": "Network & Security",
"isFavourite": false,
"categoryId": "219225000000171045"
},
{
"name": "Accounts",
"isFavourite": false,
"categoryId": "219225000000171041"
},
{
"name": "Safety",
"isFavourite": false,
"categoryId": "219225000000171037"
},
{
"name": "Customer Service",
"isFavourite": false,
"categoryId": "219225000000171033"
},
{
"name": "Games",
"isFavourite": false,
"categoryId": "219225000000171029"
},
{
"name": "Workshops",
"isFavourite": false,
"categoryId": "219225000000171025"
},
{
"name": "Mobile & Development",
"isFavourite": true,
"categoryId": "219225000000171021"
},
{
"name": "Programming & Development",
"isFavourite": false,
"categoryId": "219225000000171017"
},
{
"name": "Health & Fitness",
"isFavourite": false,
"categoryId": "219225000000171013"
},
{
"name": "Organization Policy",
"isFavourite": false,
"categoryId": "219225000000171009"
},
{
"name": "Photography",
"isFavourite": false,
"categoryId": "219225000000171005"
},
{
"name": "Marketing",
"isFavourite": false,
"categoryId": "219225000000171001"
},
{
"name": "Design",
"isFavourite": false,
"categoryId": "219225000000170997"
},
{
"name": "Personal development",
"isFavourite": false,
"categoryId": "219225000000170993"
},
{
"name": "IT & Software",
"isFavourite": true,
"categoryId": "219225000000170989"
},
{
"name": "Business Management",
"isFavourite": false,
"categoryId": "219225000000170985"
},
{
"name": "General",
"isFavourite": false,
"categoryId": "219225000000170981"
}
],
"message": "success",
"hasMoreRecords": false
}Show full
Show less