Workload

This module covers operations related to workload report within Zoho Projects.

Get Workload Report Meta Details

Retrieve workload report meta details from the Zoho projects portal.

GET

/api/v3/portal/[PORTAL_ID]/reports/workload/meta

OAuth Scope:

ZohoProjects.portals.READ

Path Parameters

Param Name

Data Type

Description

portal_id

String

required
regex : [0-9]+

Unique, immutable identifier of the portal in Zoho Projects. You can obtain it from the Get Portals API (the "id" field in the response).

Query Parameters

Param Name

Data Type

Description

project_id

int

Enter the project ID (Not required for global reports). You can obtain it from the Get Projects API (the "id" field in the response).

from_date

String

Enter the start date of the chart.

to_date

String

Enter the end date of the chart.

time_period

String

Enter the view period.
Accepted values : days,weeks,months

filter

JSONObject

Enter the filter criteria to narrow down results.

view_id

int

Enter the custom view ID.

Request Example

cURL
Deluge
Node.js
Ruby
PHP
- Python
- C
- C#
- C++
- Clojure
- Go
- HTTP
- Java
- JS Fetch
- JSON
- Kotlin
- Objective-C
- OCaml
- PowerShell
- R
- Swift

curl -X GET \
'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/meta?project_id=23806000097545166&from_date=2025-05-01T00%3A00%3A00.000Z&to_date=2025-05-31T23%3A59%3A59.999Z&time_period=days&filter=%7B%22criteria%22%3A%5B%7B%22field_name%22%3A%22project_id%22%2C%22criteria_condition%22%3A%22is%22%2C%22value%22%3A%5B%2223806000097545166%22%5D%7D%5D%2C%22pattern%22%3A%221%22%7D&view_id=23806000074760021' \
-H 'Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/meta";
filter_value = {"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"};
params = Map();
params.put("project_id", "23806000097545166");
params.put("from_date", "2025-05-01T00:00:00.000Z");
params.put("to_date", "2025-05-31T23:59:59.999Z");
params.put("time_period", "days");
params.put("filter", filter_value);
params.put("view_id", "23806000074760021");
response = invokeUrl
[
    url: url
    type: GET
    parameters: params
    connection: "projects"
];
info response;

const https = require('https');
const url = new URL('https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/meta');
url.searchParams.append('project_id', '23806000097545166');
url.searchParams.append('from_date', '2025-05-01T00:00:00.000Z');
url.searchParams.append('to_date', '2025-05-31T23:59:59.999Z');
url.searchParams.append('time_period', 'days');
url.searchParams.append('filter', '{"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"}');
url.searchParams.append('view_id', '23806000074760021');

const options = {
  hostname: url.hostname,
  path: url.pathname + url.search,
  method: 'GET',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'
  }
};

const req = https.request(options, (res) => {
  let data = '';
  res.on('data', (chunk) => { data += chunk; });
  res.on('end', () => { console.log(JSON.parse(data)); });
});

req.on('error', (err) => { console.error(err); });
req.end();

require 'net/http'
require 'uri'
require 'json'

url = URI("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/meta")
params = {
  "project_id" => "23806000097545166",
  "from_date" => "2025-05-01T00:00:00.000Z",
  "to_date" => "2025-05-31T23:59:59.999Z",
  "time_period" => "days",
  "filter" => "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}",
  "view_id" => "23806000074760021"
}
url.query = URI.encode_www_form(params)

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"

response = http.request(request)
puts response.read_body

<?php
$params = [
    'project_id' => '23806000097545166',
    'from_date' => '2025-05-01T00:00:00.000Z',
    'to_date' => '2025-05-31T23:59:59.999Z',
    'time_period' => 'days',
    'filter' => '{"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"}',
    'view_id' => '23806000074760021',
];
$url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/meta" . "?" . http_build_query($params);

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => $url,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

import requests

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/meta"

params = {
    "project_id": "23806000097545166",
    "from_date": "2025-05-01T00:00:00.000Z",
    "to_date": "2025-05-31T23:59:59.999Z",
    "time_period": "days",
    "filter": "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}",
    "view_id": "23806000074760021"
}

headers = {
    "Authorization": "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa",
}

response = requests.get(url, headers=headers, params=params)

print(response.json())

#include <stdio.h>
#include <string.h>
#include <curl/curl.h>

int main(void) {
    CURL *curl = curl_easy_init();
    if (curl) {
        char *enc_project_id = curl_easy_escape(curl, "23806000097545166", 0);
        char *enc_from_date = curl_easy_escape(curl, "2025-05-01T00:00:00.000Z", 0);
        char *enc_to_date = curl_easy_escape(curl, "2025-05-31T23:59:59.999Z", 0);
        char *enc_time_period = curl_easy_escape(curl, "days", 0);
        char *enc_filter = curl_easy_escape(curl, "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}", 0);
        char *enc_view_id = curl_easy_escape(curl, "23806000074760021", 0);
        char url[2048];
        snprintf(url, sizeof(url), "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/meta?project_id=%s&from_date=%s&to_date=%s&time_period=%s&filter=%s&view_id=%s", enc_project_id, enc_from_date, enc_to_date, enc_time_period, enc_filter, enc_view_id);

        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

        curl_easy_setopt(curl, CURLOPT_URL, url);
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");

        CURLcode res = curl_easy_perform(curl);
        if (res != CURLE_OK)
            fprintf(stderr, "curl failed: %s\n", curl_easy_strerror(res));

        curl_free(enc_project_id);
        curl_free(enc_from_date);
        curl_free(enc_to_date);
        curl_free(enc_time_period);
        curl_free(enc_filter);
        curl_free(enc_view_id);
        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

using System.Net.Http;
using System.Text;
using System.Web;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

var query = HttpUtility.ParseQueryString(string.Empty);
query["project_id"] = "23806000097545166";
query["from_date"] = "2025-05-01T00:00:00.000Z";
query["to_date"] = "2025-05-31T23:59:59.999Z";
query["time_period"] = "days";
query["filter"] = "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}";
query["view_id"] = "23806000074760021";
var uriBuilder = new UriBuilder("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/meta") { Query = query.ToString() };
var request = new HttpRequestMessage(HttpMethod.Get, uriBuilder.Uri);

var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

#include <iostream>
#include <string>
#include <curl/curl.h>

static size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* output) {
    output->append((char*)contents, size * nmemb);
    return size * nmemb;
}

int main() {
    CURL* curl = curl_easy_init();
    if (curl) {
        std::string response;
        char* enc_project_id = curl_easy_escape(curl, "23806000097545166", 0);
        char* enc_from_date = curl_easy_escape(curl, "2025-05-01T00:00:00.000Z", 0);
        char* enc_to_date = curl_easy_escape(curl, "2025-05-31T23:59:59.999Z", 0);
        char* enc_time_period = curl_easy_escape(curl, "days", 0);
        char* enc_filter = curl_easy_escape(curl, "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}", 0);
        char* enc_view_id = curl_easy_escape(curl, "23806000074760021", 0);
        std::string url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/meta";
        url += "?project_id=" + std::string(enc_project_id);
        url += "&from_date=" + std::string(enc_from_date);
        url += "&to_date=" + std::string(enc_to_date);
        url += "&time_period=" + std::string(enc_time_period);
        url += "&filter=" + std::string(enc_filter);
        url += "&view_id=" + std::string(enc_view_id);

        struct curl_slist* headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

        curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);

        CURLcode res = curl_easy_perform(curl);
        if (res == CURLE_OK)
            std::cout << response << std::endl;
        else
            std::cerr << curl_easy_strerror(res) << std::endl;

        curl_free(enc_project_id);
        curl_free(enc_from_date);
        curl_free(enc_to_date);
        curl_free(enc_time_period);
        curl_free(enc_filter);
        curl_free(enc_view_id);
        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

(require '[clj-http.client :as client])

(let [enc-project_id (java.net.URLEncoder/encode "23806000097545166" "UTF-8")
      enc-from_date (java.net.URLEncoder/encode "2025-05-01T00:00:00.000Z" "UTF-8")
      enc-to_date (java.net.URLEncoder/encode "2025-05-31T23:59:59.999Z" "UTF-8")
      enc-time_period (java.net.URLEncoder/encode "days" "UTF-8")
      enc-filter (java.net.URLEncoder/encode "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}" "UTF-8")
      enc-view_id (java.net.URLEncoder/encode "23806000074760021" "UTF-8")
      url (str "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/meta" "?project_id=" enc-project_id "&from_date=" enc-from_date "&to_date=" enc-to_date "&time_period=" enc-time_period "&filter=" enc-filter "&view_id=" enc-view_id)]
(def response
  (client/get url
    {:headers {"Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"}
     :as :json}))

(println (:body response))

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
)

func main() {
    req, _ := http.NewRequest("GET", "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/meta", nil)
    q := req.URL.Query()
    q.Add("project_id", "23806000097545166")
    q.Add("from_date", "2025-05-01T00:00:00.000Z")
    q.Add("to_date", "2025-05-31T23:59:59.999Z")
    q.Add("time_period", "days")
    q.Add("filter", "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}")
    q.Add("view_id", "23806000074760021")
    req.URL.RawQuery = q.Encode()
    req.Header.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

GET https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/meta?project_id=23806000097545166&from_date=2025-05-01T00%3A00%3A00.000Z&to_date=2025-05-31T23%3A59%3A59.999Z&time_period=days&filter=%7B%22criteria%22%3A%5B%7B%22field_name%22%3A%22project_id%22%2C%22criteria_condition%22%3A%22is%22%2C%22value%22%3A%5B%2223806000097545166%22%5D%7D%5D%2C%22pattern%22%3A%221%22%7D&view_id=23806000074760021 HTTP/1.1
Host: https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/meta?project_id=23806000097545166&from_date=2025-05-01T00%3A00%3A00.000Z&to_date=2025-05-31T23%3A59%3A59.999Z&time_period=days&filter=%7B%22criteria%22%3A%5B%7B%22field_name%22%3A%22project_id%22%2C%22criteria_condition%22%3A%22is%22%2C%22value%22%3A%5B%2223806000097545166%22%5D%7D%5D%2C%22pattern%22%3A%221%22%7D&view_id=23806000074760021
Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa

HttpClientBuilder httpClientBuilder = HttpClientBuilder.create();

SSLContext sslContext = SSLContext.getDefault();
SSLConnectionSocketFactory sslConnectionSocketFactory = new SSLConnectionSocketFactory(sslContext, NoopHostnameVerifier.INSTANCE);
CloseableHttpClient httpclient = httpClientBuilder.setSSLSocketFactory(sslConnectionSocketFactory).build();

URIBuilder uriBuilder = new URIBuilder("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/meta");
uriBuilder.addParameter("project_id", "23806000097545166");
uriBuilder.addParameter("from_date", "2025-05-01T00:00:00.000Z");
uriBuilder.addParameter("to_date", "2025-05-31T23:59:59.999Z");
uriBuilder.addParameter("time_period", "days");
uriBuilder.addParameter("filter", "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}");
uriBuilder.addParameter("view_id", "23806000074760021");
HttpUriRequest requestObj = new HttpGet(uriBuilder.build());
requestObj.addHeader("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

HttpResponse response = httpclient.execute(requestObj);

HttpEntity responseEntity = response.getEntity();
Object responseObject = EntityUtils.toString(responseEntity);
String responseString = responseObject.toString();

const url = 'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/meta';

const params = new URLSearchParams({
  'project_id': '23806000097545166',
  'from_date': '2025-05-01T00:00:00.000Z',
  'to_date': '2025-05-31T23:59:59.999Z',
  'time_period': 'days',
  'filter': '{"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"}',
  'view_id': '23806000074760021'
});

const options = {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'
  }
};

fetch(url + '?' + params.toString(), options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error(error));

project_id = "23806000097545166"
from_date = "2025-05-01T00:00:00.000Z"
to_date = "2025-05-31T23:59:59.999Z"
time_period = "days"
filter = {"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"}
view_id = "23806000074760021"

import java.net.HttpURLConnection
import java.net.URL
import okhttp3.HttpUrl.Companion.toHttpUrl

fun main() {
    val urlBuilder = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/meta".toHttpUrl().newBuilder()
    urlBuilder.addQueryParameter("project_id", "23806000097545166")
    urlBuilder.addQueryParameter("from_date", "2025-05-01T00:00:00.000Z")
    urlBuilder.addQueryParameter("to_date", "2025-05-31T23:59:59.999Z")
    urlBuilder.addQueryParameter("time_period", "days")
    urlBuilder.addQueryParameter("filter", "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}")
    urlBuilder.addQueryParameter("view_id", "23806000074760021")
    val url = URL(urlBuilder.build().toString())
    val conn = url.openConnection() as HttpURLConnection
    conn.requestMethod = "GET"
    conn.setRequestProperty("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")

    val response = conn.inputStream.bufferedReader().readText()
    println(response)
}

NSString *encodedProject_id = [@"23806000097545166" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedFrom_date = [@"2025-05-01T00:00:00.000Z" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedTo_date = [@"2025-05-31T23:59:59.999Z" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedTime_period = [@"days" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedFilter = [@"{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedView_id = [@"23806000074760021" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *urlString = [NSString stringWithFormat:@"https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/meta?project_id=%@&from_date=%@&to_date=%@&time_period=%@&filter=%@&view_id=%@", encodedProject_id, encodedFrom_date, encodedTo_date, encodedTime_period, encodedFilter, encodedView_id];
NSURL *url = [NSURL URLWithString:urlString];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
[request setHTTPMethod:@"GET"];
[request setValue:@"Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa" forHTTPHeaderField:@"Authorization"];

NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *task = [session dataTaskWithRequest:request
    completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
        NSString *result = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
        NSLog(@"%@", result);
}];
[task resume];

open Lwt
open Cohttp_lwt_unix

let () =
  let enc_project_id = Uri.pct_encode "23806000097545166" in
  let enc_from_date = Uri.pct_encode "2025-05-01T00:00:00.000Z" in
  let enc_to_date = Uri.pct_encode "2025-05-31T23:59:59.999Z" in
  let enc_time_period = Uri.pct_encode "days" in
  let enc_filter = Uri.pct_encode "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}" in
  let enc_view_id = Uri.pct_encode "23806000074760021" in
  let uri = Uri.of_string ("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/meta" ^ "?project_id=" ^ enc_project_id ^ "&from_date=" ^ enc_from_date ^ "&to_date=" ^ enc_to_date ^ "&time_period=" ^ enc_time_period ^ "&filter=" ^ enc_filter ^ "&view_id=" ^ enc_view_id) in
  let headers = Cohttp.Header.init ()
    |> fun h -> Cohttp.Header.add h "Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
  in
  Lwt_main.run (
    Client.get ~headers uri >>= fun (_, body) ->
    Cohttp_lwt.Body.to_string body >|= fun s ->
    print_endline s)

$headers = @{
    "Authorization" = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
}

$params = @{
    project_id = "23806000097545166"
    from_date = "2025-05-01T00:00:00.000Z"
    to_date = "2025-05-31T23:59:59.999Z"
    time_period = "days"
    filter = "{`"criteria`":[{`"field_name`":`"project_id`",`"criteria_condition`":`"is`",`"value`":[`"23806000097545166`"]}],`"pattern`":`"1`"}"
    view_id = "23806000074760021"
}
$queryString = ($params.GetEnumerator() | ForEach-Object { "$($_.Key)=$([System.Uri]::EscapeDataString($_.Value))" }) -join "&"
$url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/meta" + "?" + $queryString

$response = Invoke-RestMethod -Uri $url -Method GET -Headers $headers

$response | ConvertTo-Json

library(httr)

url <- "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/meta"

params <- list(
  project_id = "23806000097545166",
  from_date = "2025-05-01T00:00:00.000Z",
  to_date = "2025-05-31T23:59:59.999Z",
  time_period = "days",
  filter = "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}",
  view_id = "23806000074760021"
)

response <- GET(
  url,
  add_headers(Authorization = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"),
  query = params
)

content(response, "text")

import Foundation

var components = URLComponents(string: "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/meta")!
components.queryItems = [
    URLQueryItem(name: "project_id", value: "23806000097545166"),
    URLQueryItem(name: "from_date", value: "2025-05-01T00:00:00.000Z"),
    URLQueryItem(name: "to_date", value: "2025-05-31T23:59:59.999Z"),
    URLQueryItem(name: "time_period", value: "days"),
    URLQueryItem(name: "filter", value: "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}"),
    URLQueryItem(name: "view_id", value: "23806000074760021")
]
let url = components.url!
var request = URLRequest(url: url)
request.httpMethod = "GET"
request.setValue("Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa", forHTTPHeaderField: "Authorization")

let semaphore = DispatchSemaphore(value: 0)
let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data, let result = String(data: data, encoding: .utf8) {
        print(result)
    }
    semaphore.signal()
}
task.resume()
semaphore.wait()

Sample Input

project_id : "23806000097545166" from_date : "2025-05-01T00:00:00.000Z" to_date : "2025-05-31T23:59:59.999Z" time_period : "days" filter : { "criteria" : [ { "field_name" : "project_id", "criteria_condition" : "is", "value" : [ "23806000097545166" ] } ], "pattern" : "1" } view_id : "23806000074760021"

Sample Response

200{ "default_business_hours_details" : { "holidays" : [ ], "working_day_availability" : { "2" : 540, "3" : 540, "4" : 540, "5" : 540, "6" : 540, "7" : 540 }, "name" : "Standard Business Hours", "id" : "4000000893039", "version" : 4 }, "custom_view_id" : "4000000875269", "project_id" : "0", "filter" : "{}", "user_range" : 15, "report_based_on" : "users", "user_premission_details" : { "assign_to_self" : false, "assign_to_others" : false }, "group_by" : { "module" : "workload", "sort_by" : "asc", "field_name" : "users" }, "task_title" : true, "project_title" : true, "chart_details" : { "end_date" : "20260630", "previous_date" : "20260501", "unit" : "hours", "legend" : "allocatedhrs", "to_view" : "days", "empty_message" : "No data found", "range" : "days", "view_type" : "heatmap", "bar_type" : "gantt", "start_date" : "20260601", "next_date" : "20260701" } }

Get Workload Report Details

Retrieve workload report details from the Zoho projects portal.

GET

/api/v3/portal/[PORTAL_ID]/reports/workload

OAuth Scope:

ZohoProjects.portals.READ

Path Parameters

Param Name

Data Type

Description

portal_id

String

required
regex : [0-9]+

Unique, immutable identifier of the portal in Zoho Projects. You can obtain it from the Get Portals API (the "id" field in the response).

Query Parameters

Param Name

Data Type

Description

project_id

int

Enter the project ID (Not required for global reports). You can obtain it from the Get Projects API (the "id" field in the response).

from_date

String

Enter the start date of the chart.

to_date

String

Enter the end date of the chart.

index

int

Enter the index of the record.

range

int

Enter the range of the record.

page

int

Enter the page number to retrieve.

per_page

int

Enter the number of entries to display per page.

filter

JSONObject

Enter the filter criteria to narrow down results.

fetch_unassignee

boolean

Specify whether to fetch the details of unassigned user only.
Accepted values : true,false

grouped_ids

JSONArray

Enter the entity IDs.

search_term

String

Enter the search term to look up specific records.

sort_order

String

regex : asc|desc

Enter the sort order.
Accepted values : asc,desc

time_period

String

regex : days|weeks|months

Enter the view period.
Accepted values : days,weeks,months

report_based_on

String

regex : users|teams

Enter the report based on value.
Accepted values : users,teams

view_id

int

Enter the custom view ID.

Request Example

cURL
Deluge
Node.js
Ruby
PHP
- Python
- C
- C#
- C++
- Clojure
- Go
- HTTP
- Java
- JS Fetch
- JSON
- Kotlin
- Objective-C
- OCaml
- PowerShell
- R
- Swift

curl -X GET \
'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload?project_id=23806000097545166&from_date=2025-05-01T00%3A00%3A00Z&to_date=2025-05-31T23%3A59%3A59.999000Z&index=1&range=100&page=1&per_page=50&filter=%7B%22criteria%22%3A%5B%7B%22field_name%22%3A%22project_id%22%2C%22criteria_condition%22%3A%22is%22%2C%22value%22%3A%5B%2223806000097545166%22%5D%7D%5D%2C%22pattern%22%3A%221%22%7D&fetch_unassignee=false&grouped_ids=%5B%224000000002379%22%5D&search_term=Zoho+Projects&sort_order=asc&time_period=days&report_based_on=users&view_id=23806000074760021' \
-H 'Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload";
filter_value = {"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"};
grouped_ids_value = ["4000000002379"];
params = Map();
params.put("project_id", 23806000097545166);
params.put("from_date", "2025-05-01T00:00:00Z");
params.put("to_date", "2025-05-31T23:59:59.999000Z");
params.put("index", 1);
params.put("range", 100);
params.put("page", 1);
params.put("per_page", 50);
params.put("filter", filter_value);
params.put("fetch_unassignee", "false");
params.put("grouped_ids", grouped_ids_value);
params.put("search_term", "Zoho Projects");
params.put("sort_order", "asc");
params.put("time_period", "days");
params.put("report_based_on", "users");
params.put("view_id", "23806000074760021");
response = invokeUrl
[
    url: url
    type: GET
    parameters: params
    connection: "projects"
];
info response;

const https = require('https');
const url = new URL('https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload');
url.searchParams.append('project_id', '23806000097545166');
url.searchParams.append('from_date', '2025-05-01T00:00:00Z');
url.searchParams.append('to_date', '2025-05-31T23:59:59.999000Z');
url.searchParams.append('index', '1');
url.searchParams.append('range', '100');
url.searchParams.append('page', '1');
url.searchParams.append('per_page', '50');
url.searchParams.append('filter', '{"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"}');
url.searchParams.append('fetch_unassignee', 'false');
url.searchParams.append('grouped_ids', '["4000000002379"]');
url.searchParams.append('search_term', 'Zoho Projects');
url.searchParams.append('sort_order', 'asc');
url.searchParams.append('time_period', 'days');
url.searchParams.append('report_based_on', 'users');
url.searchParams.append('view_id', '23806000074760021');

const options = {
  hostname: url.hostname,
  path: url.pathname + url.search,
  method: 'GET',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'
  }
};

const req = https.request(options, (res) => {
  let data = '';
  res.on('data', (chunk) => { data += chunk; });
  res.on('end', () => { console.log(JSON.parse(data)); });
});

req.on('error', (err) => { console.error(err); });
req.end();

require 'net/http'
require 'uri'
require 'json'

url = URI("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload")
params = {
  "project_id" => "23806000097545166",
  "from_date" => "2025-05-01T00:00:00Z",
  "to_date" => "2025-05-31T23:59:59.999000Z",
  "index" => "1",
  "range" => "100",
  "page" => "1",
  "per_page" => "50",
  "filter" => "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}",
  "fetch_unassignee" => "false",
  "grouped_ids" => "[\"4000000002379\"]",
  "search_term" => "Zoho Projects",
  "sort_order" => "asc",
  "time_period" => "days",
  "report_based_on" => "users",
  "view_id" => "23806000074760021"
}
url.query = URI.encode_www_form(params)

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"

response = http.request(request)
puts response.read_body

<?php
$params = [
    'project_id' => '23806000097545166',
    'from_date' => '2025-05-01T00:00:00Z',
    'to_date' => '2025-05-31T23:59:59.999000Z',
    'index' => '1',
    'range' => '100',
    'page' => '1',
    'per_page' => '50',
    'filter' => '{"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"}',
    'fetch_unassignee' => 'false',
    'grouped_ids' => '["4000000002379"]',
    'search_term' => 'Zoho Projects',
    'sort_order' => 'asc',
    'time_period' => 'days',
    'report_based_on' => 'users',
    'view_id' => '23806000074760021',
];
$url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload" . "?" . http_build_query($params);

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => $url,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

import requests

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload"

params = {
    "project_id": "23806000097545166",
    "from_date": "2025-05-01T00:00:00Z",
    "to_date": "2025-05-31T23:59:59.999000Z",
    "index": "1",
    "range": "100",
    "page": "1",
    "per_page": "50",
    "filter": "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}",
    "fetch_unassignee": "false",
    "grouped_ids": "[\"4000000002379\"]",
    "search_term": "Zoho Projects",
    "sort_order": "asc",
    "time_period": "days",
    "report_based_on": "users",
    "view_id": "23806000074760021"
}

headers = {
    "Authorization": "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa",
}

response = requests.get(url, headers=headers, params=params)

print(response.json())

#include <stdio.h>
#include <string.h>
#include <curl/curl.h>

int main(void) {
    CURL *curl = curl_easy_init();
    if (curl) {
        char *enc_project_id = curl_easy_escape(curl, "23806000097545166", 0);
        char *enc_from_date = curl_easy_escape(curl, "2025-05-01T00:00:00Z", 0);
        char *enc_to_date = curl_easy_escape(curl, "2025-05-31T23:59:59.999000Z", 0);
        char *enc_index = curl_easy_escape(curl, "1", 0);
        char *enc_range = curl_easy_escape(curl, "100", 0);
        char *enc_page = curl_easy_escape(curl, "1", 0);
        char *enc_per_page = curl_easy_escape(curl, "50", 0);
        char *enc_filter = curl_easy_escape(curl, "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}", 0);
        char *enc_fetch_unassignee = curl_easy_escape(curl, "false", 0);
        char *enc_grouped_ids = curl_easy_escape(curl, "[\"4000000002379\"]", 0);
        char *enc_search_term = curl_easy_escape(curl, "Zoho Projects", 0);
        char *enc_sort_order = curl_easy_escape(curl, "asc", 0);
        char *enc_time_period = curl_easy_escape(curl, "days", 0);
        char *enc_report_based_on = curl_easy_escape(curl, "users", 0);
        char *enc_view_id = curl_easy_escape(curl, "23806000074760021", 0);
        char url[2048];
        snprintf(url, sizeof(url), "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload?project_id=%s&from_date=%s&to_date=%s&index=%s&range=%s&page=%s&per_page=%s&filter=%s&fetch_unassignee=%s&grouped_ids=%s&search_term=%s&sort_order=%s&time_period=%s&report_based_on=%s&view_id=%s", enc_project_id, enc_from_date, enc_to_date, enc_index, enc_range, enc_page, enc_per_page, enc_filter, enc_fetch_unassignee, enc_grouped_ids, enc_search_term, enc_sort_order, enc_time_period, enc_report_based_on, enc_view_id);

        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

        curl_easy_setopt(curl, CURLOPT_URL, url);
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");

        CURLcode res = curl_easy_perform(curl);
        if (res != CURLE_OK)
            fprintf(stderr, "curl failed: %s\n", curl_easy_strerror(res));

        curl_free(enc_project_id);
        curl_free(enc_from_date);
        curl_free(enc_to_date);
        curl_free(enc_index);
        curl_free(enc_range);
        curl_free(enc_page);
        curl_free(enc_per_page);
        curl_free(enc_filter);
        curl_free(enc_fetch_unassignee);
        curl_free(enc_grouped_ids);
        curl_free(enc_search_term);
        curl_free(enc_sort_order);
        curl_free(enc_time_period);
        curl_free(enc_report_based_on);
        curl_free(enc_view_id);
        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

using System.Net.Http;
using System.Text;
using System.Web;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

var query = HttpUtility.ParseQueryString(string.Empty);
query["project_id"] = "23806000097545166";
query["from_date"] = "2025-05-01T00:00:00Z";
query["to_date"] = "2025-05-31T23:59:59.999000Z";
query["index"] = "1";
query["range"] = "100";
query["page"] = "1";
query["per_page"] = "50";
query["filter"] = "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}";
query["fetch_unassignee"] = "false";
query["grouped_ids"] = "[\"4000000002379\"]";
query["search_term"] = "Zoho Projects";
query["sort_order"] = "asc";
query["time_period"] = "days";
query["report_based_on"] = "users";
query["view_id"] = "23806000074760021";
var uriBuilder = new UriBuilder("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload") { Query = query.ToString() };
var request = new HttpRequestMessage(HttpMethod.Get, uriBuilder.Uri);

var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

#include <iostream>
#include <string>
#include <curl/curl.h>

static size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* output) {
    output->append((char*)contents, size * nmemb);
    return size * nmemb;
}

int main() {
    CURL* curl = curl_easy_init();
    if (curl) {
        std::string response;
        char* enc_project_id = curl_easy_escape(curl, "23806000097545166", 0);
        char* enc_from_date = curl_easy_escape(curl, "2025-05-01T00:00:00Z", 0);
        char* enc_to_date = curl_easy_escape(curl, "2025-05-31T23:59:59.999000Z", 0);
        char* enc_index = curl_easy_escape(curl, "1", 0);
        char* enc_range = curl_easy_escape(curl, "100", 0);
        char* enc_page = curl_easy_escape(curl, "1", 0);
        char* enc_per_page = curl_easy_escape(curl, "50", 0);
        char* enc_filter = curl_easy_escape(curl, "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}", 0);
        char* enc_fetch_unassignee = curl_easy_escape(curl, "false", 0);
        char* enc_grouped_ids = curl_easy_escape(curl, "[\"4000000002379\"]", 0);
        char* enc_search_term = curl_easy_escape(curl, "Zoho Projects", 0);
        char* enc_sort_order = curl_easy_escape(curl, "asc", 0);
        char* enc_time_period = curl_easy_escape(curl, "days", 0);
        char* enc_report_based_on = curl_easy_escape(curl, "users", 0);
        char* enc_view_id = curl_easy_escape(curl, "23806000074760021", 0);
        std::string url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload";
        url += "?project_id=" + std::string(enc_project_id);
        url += "&from_date=" + std::string(enc_from_date);
        url += "&to_date=" + std::string(enc_to_date);
        url += "&index=" + std::string(enc_index);
        url += "&range=" + std::string(enc_range);
        url += "&page=" + std::string(enc_page);
        url += "&per_page=" + std::string(enc_per_page);
        url += "&filter=" + std::string(enc_filter);
        url += "&fetch_unassignee=" + std::string(enc_fetch_unassignee);
        url += "&grouped_ids=" + std::string(enc_grouped_ids);
        url += "&search_term=" + std::string(enc_search_term);
        url += "&sort_order=" + std::string(enc_sort_order);
        url += "&time_period=" + std::string(enc_time_period);
        url += "&report_based_on=" + std::string(enc_report_based_on);
        url += "&view_id=" + std::string(enc_view_id);

        struct curl_slist* headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

        curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);

        CURLcode res = curl_easy_perform(curl);
        if (res == CURLE_OK)
            std::cout << response << std::endl;
        else
            std::cerr << curl_easy_strerror(res) << std::endl;

        curl_free(enc_project_id);
        curl_free(enc_from_date);
        curl_free(enc_to_date);
        curl_free(enc_index);
        curl_free(enc_range);
        curl_free(enc_page);
        curl_free(enc_per_page);
        curl_free(enc_filter);
        curl_free(enc_fetch_unassignee);
        curl_free(enc_grouped_ids);
        curl_free(enc_search_term);
        curl_free(enc_sort_order);
        curl_free(enc_time_period);
        curl_free(enc_report_based_on);
        curl_free(enc_view_id);
        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

(require '[clj-http.client :as client])

(let [enc-project_id (java.net.URLEncoder/encode "23806000097545166" "UTF-8")
      enc-from_date (java.net.URLEncoder/encode "2025-05-01T00:00:00Z" "UTF-8")
      enc-to_date (java.net.URLEncoder/encode "2025-05-31T23:59:59.999000Z" "UTF-8")
      enc-index (java.net.URLEncoder/encode "1" "UTF-8")
      enc-range (java.net.URLEncoder/encode "100" "UTF-8")
      enc-page (java.net.URLEncoder/encode "1" "UTF-8")
      enc-per_page (java.net.URLEncoder/encode "50" "UTF-8")
      enc-filter (java.net.URLEncoder/encode "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}" "UTF-8")
      enc-fetch_unassignee (java.net.URLEncoder/encode "false" "UTF-8")
      enc-grouped_ids (java.net.URLEncoder/encode "[\"4000000002379\"]" "UTF-8")
      enc-search_term (java.net.URLEncoder/encode "Zoho Projects" "UTF-8")
      enc-sort_order (java.net.URLEncoder/encode "asc" "UTF-8")
      enc-time_period (java.net.URLEncoder/encode "days" "UTF-8")
      enc-report_based_on (java.net.URLEncoder/encode "users" "UTF-8")
      enc-view_id (java.net.URLEncoder/encode "23806000074760021" "UTF-8")
      url (str "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload" "?project_id=" enc-project_id "&from_date=" enc-from_date "&to_date=" enc-to_date "&index=" enc-index "&range=" enc-range "&page=" enc-page "&per_page=" enc-per_page "&filter=" enc-filter "&fetch_unassignee=" enc-fetch_unassignee "&grouped_ids=" enc-grouped_ids "&search_term=" enc-search_term "&sort_order=" enc-sort_order "&time_period=" enc-time_period "&report_based_on=" enc-report_based_on "&view_id=" enc-view_id)]
(def response
  (client/get url
    {:headers {"Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"}
     :as :json}))

(println (:body response))

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
)

func main() {
    req, _ := http.NewRequest("GET", "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload", nil)
    q := req.URL.Query()
    q.Add("project_id", "23806000097545166")
    q.Add("from_date", "2025-05-01T00:00:00Z")
    q.Add("to_date", "2025-05-31T23:59:59.999000Z")
    q.Add("index", "1")
    q.Add("range", "100")
    q.Add("page", "1")
    q.Add("per_page", "50")
    q.Add("filter", "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}")
    q.Add("fetch_unassignee", "false")
    q.Add("grouped_ids", "[\"4000000002379\"]")
    q.Add("search_term", "Zoho Projects")
    q.Add("sort_order", "asc")
    q.Add("time_period", "days")
    q.Add("report_based_on", "users")
    q.Add("view_id", "23806000074760021")
    req.URL.RawQuery = q.Encode()
    req.Header.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

GET https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload?project_id=23806000097545166&from_date=2025-05-01T00%3A00%3A00Z&to_date=2025-05-31T23%3A59%3A59.999000Z&index=1&range=100&page=1&per_page=50&filter=%7B%22criteria%22%3A%5B%7B%22field_name%22%3A%22project_id%22%2C%22criteria_condition%22%3A%22is%22%2C%22value%22%3A%5B%2223806000097545166%22%5D%7D%5D%2C%22pattern%22%3A%221%22%7D&fetch_unassignee=false&grouped_ids=%5B%224000000002379%22%5D&search_term=Zoho+Projects&sort_order=asc&time_period=days&report_based_on=users&view_id=23806000074760021 HTTP/1.1
Host: https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload?project_id=23806000097545166&from_date=2025-05-01T00%3A00%3A00Z&to_date=2025-05-31T23%3A59%3A59.999000Z&index=1&range=100&page=1&per_page=50&filter=%7B%22criteria%22%3A%5B%7B%22field_name%22%3A%22project_id%22%2C%22criteria_condition%22%3A%22is%22%2C%22value%22%3A%5B%2223806000097545166%22%5D%7D%5D%2C%22pattern%22%3A%221%22%7D&fetch_unassignee=false&grouped_ids=%5B%224000000002379%22%5D&search_term=Zoho+Projects&sort_order=asc&time_period=days&report_based_on=users&view_id=23806000074760021
Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa

HttpClientBuilder httpClientBuilder = HttpClientBuilder.create();

SSLContext sslContext = SSLContext.getDefault();
SSLConnectionSocketFactory sslConnectionSocketFactory = new SSLConnectionSocketFactory(sslContext, NoopHostnameVerifier.INSTANCE);
CloseableHttpClient httpclient = httpClientBuilder.setSSLSocketFactory(sslConnectionSocketFactory).build();

URIBuilder uriBuilder = new URIBuilder("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload");
uriBuilder.addParameter("project_id", "23806000097545166");
uriBuilder.addParameter("from_date", "2025-05-01T00:00:00Z");
uriBuilder.addParameter("to_date", "2025-05-31T23:59:59.999000Z");
uriBuilder.addParameter("index", "1");
uriBuilder.addParameter("range", "100");
uriBuilder.addParameter("page", "1");
uriBuilder.addParameter("per_page", "50");
uriBuilder.addParameter("filter", "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}");
uriBuilder.addParameter("fetch_unassignee", "false");
uriBuilder.addParameter("grouped_ids", "[\"4000000002379\"]");
uriBuilder.addParameter("search_term", "Zoho Projects");
uriBuilder.addParameter("sort_order", "asc");
uriBuilder.addParameter("time_period", "days");
uriBuilder.addParameter("report_based_on", "users");
uriBuilder.addParameter("view_id", "23806000074760021");
HttpUriRequest requestObj = new HttpGet(uriBuilder.build());
requestObj.addHeader("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

HttpResponse response = httpclient.execute(requestObj);

HttpEntity responseEntity = response.getEntity();
Object responseObject = EntityUtils.toString(responseEntity);
String responseString = responseObject.toString();

const url = 'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload';

const params = new URLSearchParams({
  'project_id': '23806000097545166',
  'from_date': '2025-05-01T00:00:00Z',
  'to_date': '2025-05-31T23:59:59.999000Z',
  'index': '1',
  'range': '100',
  'page': '1',
  'per_page': '50',
  'filter': '{"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"}',
  'fetch_unassignee': 'false',
  'grouped_ids': '["4000000002379"]',
  'search_term': 'Zoho Projects',
  'sort_order': 'asc',
  'time_period': 'days',
  'report_based_on': 'users',
  'view_id': '23806000074760021'
});

const options = {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'
  }
};

fetch(url + '?' + params.toString(), options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error(error));

project_id = 23806000097545166
from_date = "2025-05-01T00:00:00Z"
to_date = "2025-05-31T23:59:59.999000Z"
index = 1
range = 100
page = 1
per_page = 50
filter = {"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"}
fetch_unassignee = "false"
grouped_ids = ["4000000002379"]
search_term = "Zoho Projects"
sort_order = "asc"
time_period = "days"
report_based_on = "users"
view_id = "23806000074760021"

import java.net.HttpURLConnection
import java.net.URL
import okhttp3.HttpUrl.Companion.toHttpUrl

fun main() {
    val urlBuilder = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload".toHttpUrl().newBuilder()
    urlBuilder.addQueryParameter("project_id", "23806000097545166")
    urlBuilder.addQueryParameter("from_date", "2025-05-01T00:00:00Z")
    urlBuilder.addQueryParameter("to_date", "2025-05-31T23:59:59.999000Z")
    urlBuilder.addQueryParameter("index", "1")
    urlBuilder.addQueryParameter("range", "100")
    urlBuilder.addQueryParameter("page", "1")
    urlBuilder.addQueryParameter("per_page", "50")
    urlBuilder.addQueryParameter("filter", "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}")
    urlBuilder.addQueryParameter("fetch_unassignee", "false")
    urlBuilder.addQueryParameter("grouped_ids", "[\"4000000002379\"]")
    urlBuilder.addQueryParameter("search_term", "Zoho Projects")
    urlBuilder.addQueryParameter("sort_order", "asc")
    urlBuilder.addQueryParameter("time_period", "days")
    urlBuilder.addQueryParameter("report_based_on", "users")
    urlBuilder.addQueryParameter("view_id", "23806000074760021")
    val url = URL(urlBuilder.build().toString())
    val conn = url.openConnection() as HttpURLConnection
    conn.requestMethod = "GET"
    conn.setRequestProperty("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")

    val response = conn.inputStream.bufferedReader().readText()
    println(response)
}

NSString *encodedProject_id = [@"23806000097545166" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedFrom_date = [@"2025-05-01T00:00:00Z" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedTo_date = [@"2025-05-31T23:59:59.999000Z" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedIndex = [@"1" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedRange = [@"100" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedPage = [@"1" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedPer_page = [@"50" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedFilter = [@"{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedFetch_unassignee = [@"false" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedGrouped_ids = [@"[\"4000000002379\"]" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedSearch_term = [@"Zoho Projects" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedSort_order = [@"asc" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedTime_period = [@"days" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedReport_based_on = [@"users" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedView_id = [@"23806000074760021" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *urlString = [NSString stringWithFormat:@"https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload?project_id=%@&from_date=%@&to_date=%@&index=%@&range=%@&page=%@&per_page=%@&filter=%@&fetch_unassignee=%@&grouped_ids=%@&search_term=%@&sort_order=%@&time_period=%@&report_based_on=%@&view_id=%@", encodedProject_id, encodedFrom_date, encodedTo_date, encodedIndex, encodedRange, encodedPage, encodedPer_page, encodedFilter, encodedFetch_unassignee, encodedGrouped_ids, encodedSearch_term, encodedSort_order, encodedTime_period, encodedReport_based_on, encodedView_id];
NSURL *url = [NSURL URLWithString:urlString];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
[request setHTTPMethod:@"GET"];
[request setValue:@"Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa" forHTTPHeaderField:@"Authorization"];

NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *task = [session dataTaskWithRequest:request
    completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
        NSString *result = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
        NSLog(@"%@", result);
}];
[task resume];

open Lwt
open Cohttp_lwt_unix

let () =
  let enc_project_id = Uri.pct_encode "23806000097545166" in
  let enc_from_date = Uri.pct_encode "2025-05-01T00:00:00Z" in
  let enc_to_date = Uri.pct_encode "2025-05-31T23:59:59.999000Z" in
  let enc_index = Uri.pct_encode "1" in
  let enc_range = Uri.pct_encode "100" in
  let enc_page = Uri.pct_encode "1" in
  let enc_per_page = Uri.pct_encode "50" in
  let enc_filter = Uri.pct_encode "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}" in
  let enc_fetch_unassignee = Uri.pct_encode "false" in
  let enc_grouped_ids = Uri.pct_encode "[\"4000000002379\"]" in
  let enc_search_term = Uri.pct_encode "Zoho Projects" in
  let enc_sort_order = Uri.pct_encode "asc" in
  let enc_time_period = Uri.pct_encode "days" in
  let enc_report_based_on = Uri.pct_encode "users" in
  let enc_view_id = Uri.pct_encode "23806000074760021" in
  let uri = Uri.of_string ("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload" ^ "?project_id=" ^ enc_project_id ^ "&from_date=" ^ enc_from_date ^ "&to_date=" ^ enc_to_date ^ "&index=" ^ enc_index ^ "&range=" ^ enc_range ^ "&page=" ^ enc_page ^ "&per_page=" ^ enc_per_page ^ "&filter=" ^ enc_filter ^ "&fetch_unassignee=" ^ enc_fetch_unassignee ^ "&grouped_ids=" ^ enc_grouped_ids ^ "&search_term=" ^ enc_search_term ^ "&sort_order=" ^ enc_sort_order ^ "&time_period=" ^ enc_time_period ^ "&report_based_on=" ^ enc_report_based_on ^ "&view_id=" ^ enc_view_id) in
  let headers = Cohttp.Header.init ()
    |> fun h -> Cohttp.Header.add h "Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
  in
  Lwt_main.run (
    Client.get ~headers uri >>= fun (_, body) ->
    Cohttp_lwt.Body.to_string body >|= fun s ->
    print_endline s)

$headers = @{
    "Authorization" = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
}

$params = @{
    project_id = "23806000097545166"
    from_date = "2025-05-01T00:00:00Z"
    to_date = "2025-05-31T23:59:59.999000Z"
    index = "1"
    range = "100"
    page = "1"
    per_page = "50"
    filter = "{`"criteria`":[{`"field_name`":`"project_id`",`"criteria_condition`":`"is`",`"value`":[`"23806000097545166`"]}],`"pattern`":`"1`"}"
    fetch_unassignee = "false"
    grouped_ids = "[`"4000000002379`"]"
    search_term = "Zoho Projects"
    sort_order = "asc"
    time_period = "days"
    report_based_on = "users"
    view_id = "23806000074760021"
}
$queryString = ($params.GetEnumerator() | ForEach-Object { "$($_.Key)=$([System.Uri]::EscapeDataString($_.Value))" }) -join "&"
$url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload" + "?" + $queryString

$response = Invoke-RestMethod -Uri $url -Method GET -Headers $headers

$response | ConvertTo-Json

library(httr)

url <- "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload"

params <- list(
  project_id = "23806000097545166",
  from_date = "2025-05-01T00:00:00Z",
  to_date = "2025-05-31T23:59:59.999000Z",
  index = "1",
  range = "100",
  page = "1",
  per_page = "50",
  filter = "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}",
  fetch_unassignee = "false",
  grouped_ids = "[\"4000000002379\"]",
  search_term = "Zoho Projects",
  sort_order = "asc",
  time_period = "days",
  report_based_on = "users",
  view_id = "23806000074760021"
)

response <- GET(
  url,
  add_headers(Authorization = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"),
  query = params
)

content(response, "text")

import Foundation

var components = URLComponents(string: "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload")!
components.queryItems = [
    URLQueryItem(name: "project_id", value: "23806000097545166"),
    URLQueryItem(name: "from_date", value: "2025-05-01T00:00:00Z"),
    URLQueryItem(name: "to_date", value: "2025-05-31T23:59:59.999000Z"),
    URLQueryItem(name: "index", value: "1"),
    URLQueryItem(name: "range", value: "100"),
    URLQueryItem(name: "page", value: "1"),
    URLQueryItem(name: "per_page", value: "50"),
    URLQueryItem(name: "filter", value: "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}"),
    URLQueryItem(name: "fetch_unassignee", value: "false"),
    URLQueryItem(name: "grouped_ids", value: "[\"4000000002379\"]"),
    URLQueryItem(name: "search_term", value: "Zoho Projects"),
    URLQueryItem(name: "sort_order", value: "asc"),
    URLQueryItem(name: "time_period", value: "days"),
    URLQueryItem(name: "report_based_on", value: "users"),
    URLQueryItem(name: "view_id", value: "23806000074760021")
]
let url = components.url!
var request = URLRequest(url: url)
request.httpMethod = "GET"
request.setValue("Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa", forHTTPHeaderField: "Authorization")

let semaphore = DispatchSemaphore(value: 0)
let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data, let result = String(data: data, encoding: .utf8) {
        print(result)
    }
    semaphore.signal()
}
task.resume()
semaphore.wait()

Sample Input

project_id : 23806000097545166 from_date : "2025-05-01T00:00:00Z" to_date : "2025-05-31T23:59:59.999000Z" index : 1 range : 100 page : 1 per_page : 50 filter : { "criteria" : [ { "field_name" : "project_id", "criteria_condition" : "is", "value" : [ "23806000097545166" ] } ], "pattern" : "1" } fetch_unassignee : "false" grouped_ids : ["4000000002379"] search_term : "Zoho Projects" sort_order : "asc" time_period : "days" report_based_on : "users" view_id : "23806000074760021"

Sample Response

200{ "filter" : "{}", "business_hours" : { "default_id" : "4000000893039", "details" : [ { "holidays" : [ ], "working_day_availability" : { "2" : 540, "3" : 540, "4" : 540, "5" : 540, "6" : 540, "7" : 540 }, "name" : "Standard Business Hours", "id" : "4000000568047", "version" : 1 } ] }, "page_info" : { "index" : 1, "range" : 15, "has_next" : true }, "owners" : [ { "secondary_id" : "18891770", "work" : { "overall_allocation" : "under", "total_availability" : 13500, "total_work" : 540, "total_date_work" : [ { "date" : "20260603", "allocation" : "optimal", "work" : 540 } ], "project_date_work" : [ { "overall_allocation" : "under", "total_work" : 540, "id" : "4000000371009", "date_work" : [ { "date" : "20260603", "allocation" : "optimal", "work" : 540 } ] } ] }, "business_hours_id" : "4000000893039", "name" : "Nathan Brooks", "count" : { "users_count" : 1, "entity_count" : 1, "project_entity_count" : { "4000000371009" : 1 }, "recurring_entity_count" : 0 }, "id" : "4000001068022", "is_resource" : false } ] }

Get Allocated Work Details

Retrieve allocated work details of an existing user or resource from the Zoho Projects portal.

GET

/api/v3/portal/[PORTAL_ID]/reports/workload/owner/[OWNER_ID]/details

OAuth Scope:

ZohoProjects.portals.READ

Path Parameters

Param Name

Data Type

Description

portal_id

String

required
regex : [0-9]+

Unique, immutable identifier of the portal in Zoho Projects. You can obtain it from the Get Portals API (the "id" field in the response).

owner_id

String

required
regex : [0-9]+

Identifier of an owner. You can obtain it from the Get Portal Users API (the "id" field in the response).

Query Parameters

Param Name

Data Type

Description

project_id

int

Enter the project ID (Not required for global reports). You can obtain it from the Get Projects API (the "id" field in the response).

from_date

String

Enter the start date of the chart.

to_date

String

Enter the end date of the chart.

filter

JSONObject

Enter the filter criteria to narrow down results.

next_token

String

Enter the token to fetch the next set of owners.

time_period

String

regex : days|weeks|months

Enter the view period.
Accepted values : days,weeks,months

report_based_on

String

regex : users|teams

Enter the report based on value.
Accepted values : users,teams

view_id

int

Enter the custom view ID.

Request Example

cURL
Deluge
Node.js
Ruby
PHP
- Python
- C
- C#
- C++
- Clojure
- Go
- HTTP
- Java
- JS Fetch
- JSON
- Kotlin
- Objective-C
- OCaml
- PowerShell
- R
- Swift

curl -X GET \
'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/owner/[OWNER_ID]/details?project_id=23806000097545166&from_date=2025-05-01T00%3A00%3A00.000Z&to_date=2025-05-31T23%3A59%3A59.999Z&filter=%7B%22criteria%22%3A%5B%7B%22field_name%22%3A%22project_id%22%2C%22criteria_condition%22%3A%22is%22%2C%22value%22%3A%5B%2223806000097545166%22%5D%7D%5D%2C%22pattern%22%3A%221%22%7D&next_token=projects-%3Cnext_token%3E&time_period=days&report_based_on=users&view_id=23806000074760021' \
-H 'Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/owner/[OWNER_ID]/details";
filter_value = {"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"};
params = Map();
params.put("project_id", "23806000097545166");
params.put("from_date", "2025-05-01T00:00:00.000Z");
params.put("to_date", "2025-05-31T23:59:59.999Z");
params.put("filter", filter_value);
params.put("next_token", "projects-<next_token>");
params.put("time_period", "days");
params.put("report_based_on", "users");
params.put("view_id", "23806000074760021");
response = invokeUrl
[
    url: url
    type: GET
    parameters: params
    connection: "projects"
];
info response;

const https = require('https');
const url = new URL('https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/owner/[OWNER_ID]/details');
url.searchParams.append('project_id', '23806000097545166');
url.searchParams.append('from_date', '2025-05-01T00:00:00.000Z');
url.searchParams.append('to_date', '2025-05-31T23:59:59.999Z');
url.searchParams.append('filter', '{"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"}');
url.searchParams.append('next_token', 'projects-<next_token>');
url.searchParams.append('time_period', 'days');
url.searchParams.append('report_based_on', 'users');
url.searchParams.append('view_id', '23806000074760021');

const options = {
  hostname: url.hostname,
  path: url.pathname + url.search,
  method: 'GET',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'
  }
};

const req = https.request(options, (res) => {
  let data = '';
  res.on('data', (chunk) => { data += chunk; });
  res.on('end', () => { console.log(JSON.parse(data)); });
});

req.on('error', (err) => { console.error(err); });
req.end();

require 'net/http'
require 'uri'
require 'json'

url = URI("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/owner/[OWNER_ID]/details")
params = {
  "project_id" => "23806000097545166",
  "from_date" => "2025-05-01T00:00:00.000Z",
  "to_date" => "2025-05-31T23:59:59.999Z",
  "filter" => "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}",
  "next_token" => "projects-<next_token>",
  "time_period" => "days",
  "report_based_on" => "users",
  "view_id" => "23806000074760021"
}
url.query = URI.encode_www_form(params)

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"

response = http.request(request)
puts response.read_body

<?php
$params = [
    'project_id' => '23806000097545166',
    'from_date' => '2025-05-01T00:00:00.000Z',
    'to_date' => '2025-05-31T23:59:59.999Z',
    'filter' => '{"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"}',
    'next_token' => 'projects-<next_token>',
    'time_period' => 'days',
    'report_based_on' => 'users',
    'view_id' => '23806000074760021',
];
$url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/owner/[OWNER_ID]/details" . "?" . http_build_query($params);

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => $url,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

import requests

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/owner/[OWNER_ID]/details"

params = {
    "project_id": "23806000097545166",
    "from_date": "2025-05-01T00:00:00.000Z",
    "to_date": "2025-05-31T23:59:59.999Z",
    "filter": "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}",
    "next_token": "projects-<next_token>",
    "time_period": "days",
    "report_based_on": "users",
    "view_id": "23806000074760021"
}

headers = {
    "Authorization": "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa",
}

response = requests.get(url, headers=headers, params=params)

print(response.json())

#include <stdio.h>
#include <string.h>
#include <curl/curl.h>

int main(void) {
    CURL *curl = curl_easy_init();
    if (curl) {
        char *enc_project_id = curl_easy_escape(curl, "23806000097545166", 0);
        char *enc_from_date = curl_easy_escape(curl, "2025-05-01T00:00:00.000Z", 0);
        char *enc_to_date = curl_easy_escape(curl, "2025-05-31T23:59:59.999Z", 0);
        char *enc_filter = curl_easy_escape(curl, "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}", 0);
        char *enc_next_token = curl_easy_escape(curl, "projects-<next_token>", 0);
        char *enc_time_period = curl_easy_escape(curl, "days", 0);
        char *enc_report_based_on = curl_easy_escape(curl, "users", 0);
        char *enc_view_id = curl_easy_escape(curl, "23806000074760021", 0);
        char url[2048];
        snprintf(url, sizeof(url), "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/owner/[OWNER_ID]/details?project_id=%s&from_date=%s&to_date=%s&filter=%s&next_token=%s&time_period=%s&report_based_on=%s&view_id=%s", enc_project_id, enc_from_date, enc_to_date, enc_filter, enc_next_token, enc_time_period, enc_report_based_on, enc_view_id);

        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

        curl_easy_setopt(curl, CURLOPT_URL, url);
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");

        CURLcode res = curl_easy_perform(curl);
        if (res != CURLE_OK)
            fprintf(stderr, "curl failed: %s\n", curl_easy_strerror(res));

        curl_free(enc_project_id);
        curl_free(enc_from_date);
        curl_free(enc_to_date);
        curl_free(enc_filter);
        curl_free(enc_next_token);
        curl_free(enc_time_period);
        curl_free(enc_report_based_on);
        curl_free(enc_view_id);
        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

using System.Net.Http;
using System.Text;
using System.Web;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

var query = HttpUtility.ParseQueryString(string.Empty);
query["project_id"] = "23806000097545166";
query["from_date"] = "2025-05-01T00:00:00.000Z";
query["to_date"] = "2025-05-31T23:59:59.999Z";
query["filter"] = "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}";
query["next_token"] = "projects-<next_token>";
query["time_period"] = "days";
query["report_based_on"] = "users";
query["view_id"] = "23806000074760021";
var uriBuilder = new UriBuilder("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/owner/[OWNER_ID]/details") { Query = query.ToString() };
var request = new HttpRequestMessage(HttpMethod.Get, uriBuilder.Uri);

var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

#include <iostream>
#include <string>
#include <curl/curl.h>

static size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* output) {
    output->append((char*)contents, size * nmemb);
    return size * nmemb;
}

int main() {
    CURL* curl = curl_easy_init();
    if (curl) {
        std::string response;
        char* enc_project_id = curl_easy_escape(curl, "23806000097545166", 0);
        char* enc_from_date = curl_easy_escape(curl, "2025-05-01T00:00:00.000Z", 0);
        char* enc_to_date = curl_easy_escape(curl, "2025-05-31T23:59:59.999Z", 0);
        char* enc_filter = curl_easy_escape(curl, "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}", 0);
        char* enc_next_token = curl_easy_escape(curl, "projects-<next_token>", 0);
        char* enc_time_period = curl_easy_escape(curl, "days", 0);
        char* enc_report_based_on = curl_easy_escape(curl, "users", 0);
        char* enc_view_id = curl_easy_escape(curl, "23806000074760021", 0);
        std::string url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/owner/[OWNER_ID]/details";
        url += "?project_id=" + std::string(enc_project_id);
        url += "&from_date=" + std::string(enc_from_date);
        url += "&to_date=" + std::string(enc_to_date);
        url += "&filter=" + std::string(enc_filter);
        url += "&next_token=" + std::string(enc_next_token);
        url += "&time_period=" + std::string(enc_time_period);
        url += "&report_based_on=" + std::string(enc_report_based_on);
        url += "&view_id=" + std::string(enc_view_id);

        struct curl_slist* headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

        curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);

        CURLcode res = curl_easy_perform(curl);
        if (res == CURLE_OK)
            std::cout << response << std::endl;
        else
            std::cerr << curl_easy_strerror(res) << std::endl;

        curl_free(enc_project_id);
        curl_free(enc_from_date);
        curl_free(enc_to_date);
        curl_free(enc_filter);
        curl_free(enc_next_token);
        curl_free(enc_time_period);
        curl_free(enc_report_based_on);
        curl_free(enc_view_id);
        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

(require '[clj-http.client :as client])

(let [enc-project_id (java.net.URLEncoder/encode "23806000097545166" "UTF-8")
      enc-from_date (java.net.URLEncoder/encode "2025-05-01T00:00:00.000Z" "UTF-8")
      enc-to_date (java.net.URLEncoder/encode "2025-05-31T23:59:59.999Z" "UTF-8")
      enc-filter (java.net.URLEncoder/encode "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}" "UTF-8")
      enc-next_token (java.net.URLEncoder/encode "projects-<next_token>" "UTF-8")
      enc-time_period (java.net.URLEncoder/encode "days" "UTF-8")
      enc-report_based_on (java.net.URLEncoder/encode "users" "UTF-8")
      enc-view_id (java.net.URLEncoder/encode "23806000074760021" "UTF-8")
      url (str "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/owner/[OWNER_ID]/details" "?project_id=" enc-project_id "&from_date=" enc-from_date "&to_date=" enc-to_date "&filter=" enc-filter "&next_token=" enc-next_token "&time_period=" enc-time_period "&report_based_on=" enc-report_based_on "&view_id=" enc-view_id)]
(def response
  (client/get url
    {:headers {"Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"}
     :as :json}))

(println (:body response))

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
)

func main() {
    req, _ := http.NewRequest("GET", "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/owner/[OWNER_ID]/details", nil)
    q := req.URL.Query()
    q.Add("project_id", "23806000097545166")
    q.Add("from_date", "2025-05-01T00:00:00.000Z")
    q.Add("to_date", "2025-05-31T23:59:59.999Z")
    q.Add("filter", "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}")
    q.Add("next_token", "projects-<next_token>")
    q.Add("time_period", "days")
    q.Add("report_based_on", "users")
    q.Add("view_id", "23806000074760021")
    req.URL.RawQuery = q.Encode()
    req.Header.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

GET https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/owner/[OWNER_ID]/details?project_id=23806000097545166&from_date=2025-05-01T00%3A00%3A00.000Z&to_date=2025-05-31T23%3A59%3A59.999Z&filter=%7B%22criteria%22%3A%5B%7B%22field_name%22%3A%22project_id%22%2C%22criteria_condition%22%3A%22is%22%2C%22value%22%3A%5B%2223806000097545166%22%5D%7D%5D%2C%22pattern%22%3A%221%22%7D&next_token=projects-%3Cnext_token%3E&time_period=days&report_based_on=users&view_id=23806000074760021 HTTP/1.1
Host: https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/owner/[OWNER_ID]/details?project_id=23806000097545166&from_date=2025-05-01T00%3A00%3A00.000Z&to_date=2025-05-31T23%3A59%3A59.999Z&filter=%7B%22criteria%22%3A%5B%7B%22field_name%22%3A%22project_id%22%2C%22criteria_condition%22%3A%22is%22%2C%22value%22%3A%5B%2223806000097545166%22%5D%7D%5D%2C%22pattern%22%3A%221%22%7D&next_token=projects-%3Cnext_token%3E&time_period=days&report_based_on=users&view_id=23806000074760021
Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa

HttpClientBuilder httpClientBuilder = HttpClientBuilder.create();

SSLContext sslContext = SSLContext.getDefault();
SSLConnectionSocketFactory sslConnectionSocketFactory = new SSLConnectionSocketFactory(sslContext, NoopHostnameVerifier.INSTANCE);
CloseableHttpClient httpclient = httpClientBuilder.setSSLSocketFactory(sslConnectionSocketFactory).build();

URIBuilder uriBuilder = new URIBuilder("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/owner/[OWNER_ID]/details");
uriBuilder.addParameter("project_id", "23806000097545166");
uriBuilder.addParameter("from_date", "2025-05-01T00:00:00.000Z");
uriBuilder.addParameter("to_date", "2025-05-31T23:59:59.999Z");
uriBuilder.addParameter("filter", "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}");
uriBuilder.addParameter("next_token", "projects-<next_token>");
uriBuilder.addParameter("time_period", "days");
uriBuilder.addParameter("report_based_on", "users");
uriBuilder.addParameter("view_id", "23806000074760021");
HttpUriRequest requestObj = new HttpGet(uriBuilder.build());
requestObj.addHeader("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

HttpResponse response = httpclient.execute(requestObj);

HttpEntity responseEntity = response.getEntity();
Object responseObject = EntityUtils.toString(responseEntity);
String responseString = responseObject.toString();

const url = 'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/owner/[OWNER_ID]/details';

const params = new URLSearchParams({
  'project_id': '23806000097545166',
  'from_date': '2025-05-01T00:00:00.000Z',
  'to_date': '2025-05-31T23:59:59.999Z',
  'filter': '{"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"}',
  'next_token': 'projects-<next_token>',
  'time_period': 'days',
  'report_based_on': 'users',
  'view_id': '23806000074760021'
});

const options = {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'
  }
};

fetch(url + '?' + params.toString(), options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error(error));

project_id = "23806000097545166"
from_date = "2025-05-01T00:00:00.000Z"
to_date = "2025-05-31T23:59:59.999Z"
filter = {"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"}
next_token = "projects-<next_token>"
time_period = "days"
report_based_on = "users"
view_id = "23806000074760021"

import java.net.HttpURLConnection
import java.net.URL
import okhttp3.HttpUrl.Companion.toHttpUrl

fun main() {
    val urlBuilder = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/owner/[OWNER_ID]/details".toHttpUrl().newBuilder()
    urlBuilder.addQueryParameter("project_id", "23806000097545166")
    urlBuilder.addQueryParameter("from_date", "2025-05-01T00:00:00.000Z")
    urlBuilder.addQueryParameter("to_date", "2025-05-31T23:59:59.999Z")
    urlBuilder.addQueryParameter("filter", "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}")
    urlBuilder.addQueryParameter("next_token", "projects-<next_token>")
    urlBuilder.addQueryParameter("time_period", "days")
    urlBuilder.addQueryParameter("report_based_on", "users")
    urlBuilder.addQueryParameter("view_id", "23806000074760021")
    val url = URL(urlBuilder.build().toString())
    val conn = url.openConnection() as HttpURLConnection
    conn.requestMethod = "GET"
    conn.setRequestProperty("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")

    val response = conn.inputStream.bufferedReader().readText()
    println(response)
}

NSString *encodedProject_id = [@"23806000097545166" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedFrom_date = [@"2025-05-01T00:00:00.000Z" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedTo_date = [@"2025-05-31T23:59:59.999Z" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedFilter = [@"{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedNext_token = [@"projects-<next_token>" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedTime_period = [@"days" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedReport_based_on = [@"users" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedView_id = [@"23806000074760021" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *urlString = [NSString stringWithFormat:@"https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/owner/[OWNER_ID]/details?project_id=%@&from_date=%@&to_date=%@&filter=%@&next_token=%@&time_period=%@&report_based_on=%@&view_id=%@", encodedProject_id, encodedFrom_date, encodedTo_date, encodedFilter, encodedNext_token, encodedTime_period, encodedReport_based_on, encodedView_id];
NSURL *url = [NSURL URLWithString:urlString];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
[request setHTTPMethod:@"GET"];
[request setValue:@"Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa" forHTTPHeaderField:@"Authorization"];

NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *task = [session dataTaskWithRequest:request
    completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
        NSString *result = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
        NSLog(@"%@", result);
}];
[task resume];

open Lwt
open Cohttp_lwt_unix

let () =
  let enc_project_id = Uri.pct_encode "23806000097545166" in
  let enc_from_date = Uri.pct_encode "2025-05-01T00:00:00.000Z" in
  let enc_to_date = Uri.pct_encode "2025-05-31T23:59:59.999Z" in
  let enc_filter = Uri.pct_encode "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}" in
  let enc_next_token = Uri.pct_encode "projects-<next_token>" in
  let enc_time_period = Uri.pct_encode "days" in
  let enc_report_based_on = Uri.pct_encode "users" in
  let enc_view_id = Uri.pct_encode "23806000074760021" in
  let uri = Uri.of_string ("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/owner/[OWNER_ID]/details" ^ "?project_id=" ^ enc_project_id ^ "&from_date=" ^ enc_from_date ^ "&to_date=" ^ enc_to_date ^ "&filter=" ^ enc_filter ^ "&next_token=" ^ enc_next_token ^ "&time_period=" ^ enc_time_period ^ "&report_based_on=" ^ enc_report_based_on ^ "&view_id=" ^ enc_view_id) in
  let headers = Cohttp.Header.init ()
    |> fun h -> Cohttp.Header.add h "Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
  in
  Lwt_main.run (
    Client.get ~headers uri >>= fun (_, body) ->
    Cohttp_lwt.Body.to_string body >|= fun s ->
    print_endline s)

$headers = @{
    "Authorization" = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
}

$params = @{
    project_id = "23806000097545166"
    from_date = "2025-05-01T00:00:00.000Z"
    to_date = "2025-05-31T23:59:59.999Z"
    filter = "{`"criteria`":[{`"field_name`":`"project_id`",`"criteria_condition`":`"is`",`"value`":[`"23806000097545166`"]}],`"pattern`":`"1`"}"
    next_token = "projects-<next_token>"
    time_period = "days"
    report_based_on = "users"
    view_id = "23806000074760021"
}
$queryString = ($params.GetEnumerator() | ForEach-Object { "$($_.Key)=$([System.Uri]::EscapeDataString($_.Value))" }) -join "&"
$url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/owner/[OWNER_ID]/details" + "?" + $queryString

$response = Invoke-RestMethod -Uri $url -Method GET -Headers $headers

$response | ConvertTo-Json

library(httr)

url <- "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/owner/[OWNER_ID]/details"

params <- list(
  project_id = "23806000097545166",
  from_date = "2025-05-01T00:00:00.000Z",
  to_date = "2025-05-31T23:59:59.999Z",
  filter = "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}",
  next_token = "projects-<next_token>",
  time_period = "days",
  report_based_on = "users",
  view_id = "23806000074760021"
)

response <- GET(
  url,
  add_headers(Authorization = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"),
  query = params
)

content(response, "text")

import Foundation

var components = URLComponents(string: "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/owner/[OWNER_ID]/details")!
components.queryItems = [
    URLQueryItem(name: "project_id", value: "23806000097545166"),
    URLQueryItem(name: "from_date", value: "2025-05-01T00:00:00.000Z"),
    URLQueryItem(name: "to_date", value: "2025-05-31T23:59:59.999Z"),
    URLQueryItem(name: "filter", value: "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}"),
    URLQueryItem(name: "next_token", value: "projects-<next_token>"),
    URLQueryItem(name: "time_period", value: "days"),
    URLQueryItem(name: "report_based_on", value: "users"),
    URLQueryItem(name: "view_id", value: "23806000074760021")
]
let url = components.url!
var request = URLRequest(url: url)
request.httpMethod = "GET"
request.setValue("Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa", forHTTPHeaderField: "Authorization")

let semaphore = DispatchSemaphore(value: 0)
let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data, let result = String(data: data, encoding: .utf8) {
        print(result)
    }
    semaphore.signal()
}
task.resume()
semaphore.wait()

Sample Input

project_id : "23806000097545166" from_date : "2025-05-01T00:00:00.000Z" to_date : "2025-05-31T23:59:59.999Z" filter : { "criteria" : [ { "field_name" : "project_id", "criteria_condition" : "is", "value" : [ "23806000097545166" ] } ], "pattern" : "1" } next_token : "projects-<next_token>" time_period : "days" report_based_on : "users" view_id : "23806000074760021"

Sample Response

200{ "id" : "4000001068022", "next_token" : "projects-99de5bbbfd5a29869a95cc2a0c02730fe77b9cf67ad2b7f5800445cc01583e26", "entity_details" : [ { "id" : "4000000735001", "name" : "Network Throttle Test", "is_parent" : false, "custom_status_id" : "4000000000356", "start_date" : "2025-05-06 09:00", "end_date" : "2025-05-08 15:00", "duration" : "3", "percent_complete" : "0", "is_duration_work" : true, "is_closed" : false, "work_type" : "0", "is_cascade_work" : false, "item_number" : "WR1-T70", "day_work" : [ { "date" : "2025-05-06", "work" : "540" }, { "date" : "2025-05-08", "work" : "360" }, { "date" : "2025-05-07", "work" : "540" } ], "project_id" : "4000000303005", "duration_hours" : "24:0", "business_hour_id" : "4000000568047", "total_work" : "1440" } ] }

Get Allocated Work Details Of Multiple Users

Retrieve allocated work details of multiple users or resources from the Zoho Projects portal.

GET

/api/v3/portal/[PORTAL_ID]/reports/workload/details

OAuth Scope:

ZohoProjects.portals.READ

Path Parameters

Param Name

Data Type

Description

portal_id

String

required
regex : [0-9]+

Unique, immutable identifier of the portal in Zoho Projects. You can obtain it from the Get Portals API (the "id" field in the response).

Query Parameters

Param Name

Data Type

Description

project_id

int

Enter the project ID (Not required for global reports). You can obtain it from the Get Projects API (the "id" field in the response).

from_date

String

Enter the start date of the chart.

to_date

String

Enter the end date of the chart.

index

int

Enter the index of the record.

range

int

Enter the range of the record.

page

int

Enter the page number to retrieve.

per_page

int

Enter the number of entries to display per page.

filter

JSONObject

Enter the filter criteria to narrow down results.

grouped_ids

JSONArray

Enter the entity IDs.

time_period

String

regex : days|weeks|months

Enter the view period.
Accepted values : days,weeks,months

report_based_on

String

regex : users|teams

Enter the report based on value.
Accepted values : users,teams

view_id

int

Enter the custom view ID.

Request Example

cURL
Deluge
Node.js
Ruby
PHP
- Python
- C
- C#
- C++
- Clojure
- Go
- HTTP
- Java
- JS Fetch
- JSON
- Kotlin
- Objective-C
- OCaml
- PowerShell
- R
- Swift

curl -X GET \
'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/details?project_id=23806000097545166&from_date=2025-05-01T00%3A00%3A00.000Z&to_date=2025-05-31T23%3A59%3A59.999Z&index=1&range=100&page=1&per_page=50&filter=%7B%22criteria%22%3A%5B%7B%22field_name%22%3A%22project_id%22%2C%22criteria_condition%22%3A%22is%22%2C%22value%22%3A%5B%2223806000097545166%22%5D%7D%5D%2C%22pattern%22%3A%221%22%7D&grouped_ids=%5B%224000000002379%22%5D&time_period=days&report_based_on=users&view_id=23806000074760021' \
-H 'Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/details";
filter_value = {"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"};
grouped_ids_value = ["4000000002379"];
params = Map();
params.put("project_id", "23806000097545166");
params.put("from_date", "2025-05-01T00:00:00.000Z");
params.put("to_date", "2025-05-31T23:59:59.999Z");
params.put("index", "1");
params.put("range", "100");
params.put("page", 1);
params.put("per_page", 50);
params.put("filter", filter_value);
params.put("grouped_ids", grouped_ids_value);
params.put("time_period", "days");
params.put("report_based_on", "users");
params.put("view_id", "23806000074760021");
response = invokeUrl
[
    url: url
    type: GET
    parameters: params
    connection: "projects"
];
info response;

const https = require('https');
const url = new URL('https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/details');
url.searchParams.append('project_id', '23806000097545166');
url.searchParams.append('from_date', '2025-05-01T00:00:00.000Z');
url.searchParams.append('to_date', '2025-05-31T23:59:59.999Z');
url.searchParams.append('index', '1');
url.searchParams.append('range', '100');
url.searchParams.append('page', '1');
url.searchParams.append('per_page', '50');
url.searchParams.append('filter', '{"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"}');
url.searchParams.append('grouped_ids', '["4000000002379"]');
url.searchParams.append('time_period', 'days');
url.searchParams.append('report_based_on', 'users');
url.searchParams.append('view_id', '23806000074760021');

const options = {
  hostname: url.hostname,
  path: url.pathname + url.search,
  method: 'GET',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'
  }
};

const req = https.request(options, (res) => {
  let data = '';
  res.on('data', (chunk) => { data += chunk; });
  res.on('end', () => { console.log(JSON.parse(data)); });
});

req.on('error', (err) => { console.error(err); });
req.end();

require 'net/http'
require 'uri'
require 'json'

url = URI("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/details")
params = {
  "project_id" => "23806000097545166",
  "from_date" => "2025-05-01T00:00:00.000Z",
  "to_date" => "2025-05-31T23:59:59.999Z",
  "index" => "1",
  "range" => "100",
  "page" => "1",
  "per_page" => "50",
  "filter" => "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}",
  "grouped_ids" => "[\"4000000002379\"]",
  "time_period" => "days",
  "report_based_on" => "users",
  "view_id" => "23806000074760021"
}
url.query = URI.encode_www_form(params)

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"

response = http.request(request)
puts response.read_body

<?php
$params = [
    'project_id' => '23806000097545166',
    'from_date' => '2025-05-01T00:00:00.000Z',
    'to_date' => '2025-05-31T23:59:59.999Z',
    'index' => '1',
    'range' => '100',
    'page' => '1',
    'per_page' => '50',
    'filter' => '{"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"}',
    'grouped_ids' => '["4000000002379"]',
    'time_period' => 'days',
    'report_based_on' => 'users',
    'view_id' => '23806000074760021',
];
$url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/details" . "?" . http_build_query($params);

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => $url,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

import requests

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/details"

params = {
    "project_id": "23806000097545166",
    "from_date": "2025-05-01T00:00:00.000Z",
    "to_date": "2025-05-31T23:59:59.999Z",
    "index": "1",
    "range": "100",
    "page": "1",
    "per_page": "50",
    "filter": "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}",
    "grouped_ids": "[\"4000000002379\"]",
    "time_period": "days",
    "report_based_on": "users",
    "view_id": "23806000074760021"
}

headers = {
    "Authorization": "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa",
}

response = requests.get(url, headers=headers, params=params)

print(response.json())

#include <stdio.h>
#include <string.h>
#include <curl/curl.h>

int main(void) {
    CURL *curl = curl_easy_init();
    if (curl) {
        char *enc_project_id = curl_easy_escape(curl, "23806000097545166", 0);
        char *enc_from_date = curl_easy_escape(curl, "2025-05-01T00:00:00.000Z", 0);
        char *enc_to_date = curl_easy_escape(curl, "2025-05-31T23:59:59.999Z", 0);
        char *enc_index = curl_easy_escape(curl, "1", 0);
        char *enc_range = curl_easy_escape(curl, "100", 0);
        char *enc_page = curl_easy_escape(curl, "1", 0);
        char *enc_per_page = curl_easy_escape(curl, "50", 0);
        char *enc_filter = curl_easy_escape(curl, "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}", 0);
        char *enc_grouped_ids = curl_easy_escape(curl, "[\"4000000002379\"]", 0);
        char *enc_time_period = curl_easy_escape(curl, "days", 0);
        char *enc_report_based_on = curl_easy_escape(curl, "users", 0);
        char *enc_view_id = curl_easy_escape(curl, "23806000074760021", 0);
        char url[2048];
        snprintf(url, sizeof(url), "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/details?project_id=%s&from_date=%s&to_date=%s&index=%s&range=%s&page=%s&per_page=%s&filter=%s&grouped_ids=%s&time_period=%s&report_based_on=%s&view_id=%s", enc_project_id, enc_from_date, enc_to_date, enc_index, enc_range, enc_page, enc_per_page, enc_filter, enc_grouped_ids, enc_time_period, enc_report_based_on, enc_view_id);

        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

        curl_easy_setopt(curl, CURLOPT_URL, url);
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");

        CURLcode res = curl_easy_perform(curl);
        if (res != CURLE_OK)
            fprintf(stderr, "curl failed: %s\n", curl_easy_strerror(res));

        curl_free(enc_project_id);
        curl_free(enc_from_date);
        curl_free(enc_to_date);
        curl_free(enc_index);
        curl_free(enc_range);
        curl_free(enc_page);
        curl_free(enc_per_page);
        curl_free(enc_filter);
        curl_free(enc_grouped_ids);
        curl_free(enc_time_period);
        curl_free(enc_report_based_on);
        curl_free(enc_view_id);
        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

using System.Net.Http;
using System.Text;
using System.Web;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

var query = HttpUtility.ParseQueryString(string.Empty);
query["project_id"] = "23806000097545166";
query["from_date"] = "2025-05-01T00:00:00.000Z";
query["to_date"] = "2025-05-31T23:59:59.999Z";
query["index"] = "1";
query["range"] = "100";
query["page"] = "1";
query["per_page"] = "50";
query["filter"] = "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}";
query["grouped_ids"] = "[\"4000000002379\"]";
query["time_period"] = "days";
query["report_based_on"] = "users";
query["view_id"] = "23806000074760021";
var uriBuilder = new UriBuilder("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/details") { Query = query.ToString() };
var request = new HttpRequestMessage(HttpMethod.Get, uriBuilder.Uri);

var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

#include <iostream>
#include <string>
#include <curl/curl.h>

static size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* output) {
    output->append((char*)contents, size * nmemb);
    return size * nmemb;
}

int main() {
    CURL* curl = curl_easy_init();
    if (curl) {
        std::string response;
        char* enc_project_id = curl_easy_escape(curl, "23806000097545166", 0);
        char* enc_from_date = curl_easy_escape(curl, "2025-05-01T00:00:00.000Z", 0);
        char* enc_to_date = curl_easy_escape(curl, "2025-05-31T23:59:59.999Z", 0);
        char* enc_index = curl_easy_escape(curl, "1", 0);
        char* enc_range = curl_easy_escape(curl, "100", 0);
        char* enc_page = curl_easy_escape(curl, "1", 0);
        char* enc_per_page = curl_easy_escape(curl, "50", 0);
        char* enc_filter = curl_easy_escape(curl, "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}", 0);
        char* enc_grouped_ids = curl_easy_escape(curl, "[\"4000000002379\"]", 0);
        char* enc_time_period = curl_easy_escape(curl, "days", 0);
        char* enc_report_based_on = curl_easy_escape(curl, "users", 0);
        char* enc_view_id = curl_easy_escape(curl, "23806000074760021", 0);
        std::string url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/details";
        url += "?project_id=" + std::string(enc_project_id);
        url += "&from_date=" + std::string(enc_from_date);
        url += "&to_date=" + std::string(enc_to_date);
        url += "&index=" + std::string(enc_index);
        url += "&range=" + std::string(enc_range);
        url += "&page=" + std::string(enc_page);
        url += "&per_page=" + std::string(enc_per_page);
        url += "&filter=" + std::string(enc_filter);
        url += "&grouped_ids=" + std::string(enc_grouped_ids);
        url += "&time_period=" + std::string(enc_time_period);
        url += "&report_based_on=" + std::string(enc_report_based_on);
        url += "&view_id=" + std::string(enc_view_id);

        struct curl_slist* headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

        curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);

        CURLcode res = curl_easy_perform(curl);
        if (res == CURLE_OK)
            std::cout << response << std::endl;
        else
            std::cerr << curl_easy_strerror(res) << std::endl;

        curl_free(enc_project_id);
        curl_free(enc_from_date);
        curl_free(enc_to_date);
        curl_free(enc_index);
        curl_free(enc_range);
        curl_free(enc_page);
        curl_free(enc_per_page);
        curl_free(enc_filter);
        curl_free(enc_grouped_ids);
        curl_free(enc_time_period);
        curl_free(enc_report_based_on);
        curl_free(enc_view_id);
        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

(require '[clj-http.client :as client])

(let [enc-project_id (java.net.URLEncoder/encode "23806000097545166" "UTF-8")
      enc-from_date (java.net.URLEncoder/encode "2025-05-01T00:00:00.000Z" "UTF-8")
      enc-to_date (java.net.URLEncoder/encode "2025-05-31T23:59:59.999Z" "UTF-8")
      enc-index (java.net.URLEncoder/encode "1" "UTF-8")
      enc-range (java.net.URLEncoder/encode "100" "UTF-8")
      enc-page (java.net.URLEncoder/encode "1" "UTF-8")
      enc-per_page (java.net.URLEncoder/encode "50" "UTF-8")
      enc-filter (java.net.URLEncoder/encode "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}" "UTF-8")
      enc-grouped_ids (java.net.URLEncoder/encode "[\"4000000002379\"]" "UTF-8")
      enc-time_period (java.net.URLEncoder/encode "days" "UTF-8")
      enc-report_based_on (java.net.URLEncoder/encode "users" "UTF-8")
      enc-view_id (java.net.URLEncoder/encode "23806000074760021" "UTF-8")
      url (str "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/details" "?project_id=" enc-project_id "&from_date=" enc-from_date "&to_date=" enc-to_date "&index=" enc-index "&range=" enc-range "&page=" enc-page "&per_page=" enc-per_page "&filter=" enc-filter "&grouped_ids=" enc-grouped_ids "&time_period=" enc-time_period "&report_based_on=" enc-report_based_on "&view_id=" enc-view_id)]
(def response
  (client/get url
    {:headers {"Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"}
     :as :json}))

(println (:body response))

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
)

func main() {
    req, _ := http.NewRequest("GET", "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/details", nil)
    q := req.URL.Query()
    q.Add("project_id", "23806000097545166")
    q.Add("from_date", "2025-05-01T00:00:00.000Z")
    q.Add("to_date", "2025-05-31T23:59:59.999Z")
    q.Add("index", "1")
    q.Add("range", "100")
    q.Add("page", "1")
    q.Add("per_page", "50")
    q.Add("filter", "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}")
    q.Add("grouped_ids", "[\"4000000002379\"]")
    q.Add("time_period", "days")
    q.Add("report_based_on", "users")
    q.Add("view_id", "23806000074760021")
    req.URL.RawQuery = q.Encode()
    req.Header.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

GET https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/details?project_id=23806000097545166&from_date=2025-05-01T00%3A00%3A00.000Z&to_date=2025-05-31T23%3A59%3A59.999Z&index=1&range=100&page=1&per_page=50&filter=%7B%22criteria%22%3A%5B%7B%22field_name%22%3A%22project_id%22%2C%22criteria_condition%22%3A%22is%22%2C%22value%22%3A%5B%2223806000097545166%22%5D%7D%5D%2C%22pattern%22%3A%221%22%7D&grouped_ids=%5B%224000000002379%22%5D&time_period=days&report_based_on=users&view_id=23806000074760021 HTTP/1.1
Host: https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/details?project_id=23806000097545166&from_date=2025-05-01T00%3A00%3A00.000Z&to_date=2025-05-31T23%3A59%3A59.999Z&index=1&range=100&page=1&per_page=50&filter=%7B%22criteria%22%3A%5B%7B%22field_name%22%3A%22project_id%22%2C%22criteria_condition%22%3A%22is%22%2C%22value%22%3A%5B%2223806000097545166%22%5D%7D%5D%2C%22pattern%22%3A%221%22%7D&grouped_ids=%5B%224000000002379%22%5D&time_period=days&report_based_on=users&view_id=23806000074760021
Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa

HttpClientBuilder httpClientBuilder = HttpClientBuilder.create();

SSLContext sslContext = SSLContext.getDefault();
SSLConnectionSocketFactory sslConnectionSocketFactory = new SSLConnectionSocketFactory(sslContext, NoopHostnameVerifier.INSTANCE);
CloseableHttpClient httpclient = httpClientBuilder.setSSLSocketFactory(sslConnectionSocketFactory).build();

URIBuilder uriBuilder = new URIBuilder("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/details");
uriBuilder.addParameter("project_id", "23806000097545166");
uriBuilder.addParameter("from_date", "2025-05-01T00:00:00.000Z");
uriBuilder.addParameter("to_date", "2025-05-31T23:59:59.999Z");
uriBuilder.addParameter("index", "1");
uriBuilder.addParameter("range", "100");
uriBuilder.addParameter("page", "1");
uriBuilder.addParameter("per_page", "50");
uriBuilder.addParameter("filter", "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}");
uriBuilder.addParameter("grouped_ids", "[\"4000000002379\"]");
uriBuilder.addParameter("time_period", "days");
uriBuilder.addParameter("report_based_on", "users");
uriBuilder.addParameter("view_id", "23806000074760021");
HttpUriRequest requestObj = new HttpGet(uriBuilder.build());
requestObj.addHeader("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

HttpResponse response = httpclient.execute(requestObj);

HttpEntity responseEntity = response.getEntity();
Object responseObject = EntityUtils.toString(responseEntity);
String responseString = responseObject.toString();

const url = 'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/details';

const params = new URLSearchParams({
  'project_id': '23806000097545166',
  'from_date': '2025-05-01T00:00:00.000Z',
  'to_date': '2025-05-31T23:59:59.999Z',
  'index': '1',
  'range': '100',
  'page': '1',
  'per_page': '50',
  'filter': '{"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"}',
  'grouped_ids': '["4000000002379"]',
  'time_period': 'days',
  'report_based_on': 'users',
  'view_id': '23806000074760021'
});

const options = {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'
  }
};

fetch(url + '?' + params.toString(), options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error(error));

project_id = "23806000097545166"
from_date = "2025-05-01T00:00:00.000Z"
to_date = "2025-05-31T23:59:59.999Z"
index = "1"
range = "100"
page = 1
per_page = 50
filter = {"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"}
grouped_ids = ["4000000002379"]
time_period = "days"
report_based_on = "users"
view_id = "23806000074760021"

import java.net.HttpURLConnection
import java.net.URL
import okhttp3.HttpUrl.Companion.toHttpUrl

fun main() {
    val urlBuilder = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/details".toHttpUrl().newBuilder()
    urlBuilder.addQueryParameter("project_id", "23806000097545166")
    urlBuilder.addQueryParameter("from_date", "2025-05-01T00:00:00.000Z")
    urlBuilder.addQueryParameter("to_date", "2025-05-31T23:59:59.999Z")
    urlBuilder.addQueryParameter("index", "1")
    urlBuilder.addQueryParameter("range", "100")
    urlBuilder.addQueryParameter("page", "1")
    urlBuilder.addQueryParameter("per_page", "50")
    urlBuilder.addQueryParameter("filter", "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}")
    urlBuilder.addQueryParameter("grouped_ids", "[\"4000000002379\"]")
    urlBuilder.addQueryParameter("time_period", "days")
    urlBuilder.addQueryParameter("report_based_on", "users")
    urlBuilder.addQueryParameter("view_id", "23806000074760021")
    val url = URL(urlBuilder.build().toString())
    val conn = url.openConnection() as HttpURLConnection
    conn.requestMethod = "GET"
    conn.setRequestProperty("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")

    val response = conn.inputStream.bufferedReader().readText()
    println(response)
}

NSString *encodedProject_id = [@"23806000097545166" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedFrom_date = [@"2025-05-01T00:00:00.000Z" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedTo_date = [@"2025-05-31T23:59:59.999Z" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedIndex = [@"1" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedRange = [@"100" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedPage = [@"1" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedPer_page = [@"50" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedFilter = [@"{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedGrouped_ids = [@"[\"4000000002379\"]" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedTime_period = [@"days" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedReport_based_on = [@"users" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedView_id = [@"23806000074760021" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *urlString = [NSString stringWithFormat:@"https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/details?project_id=%@&from_date=%@&to_date=%@&index=%@&range=%@&page=%@&per_page=%@&filter=%@&grouped_ids=%@&time_period=%@&report_based_on=%@&view_id=%@", encodedProject_id, encodedFrom_date, encodedTo_date, encodedIndex, encodedRange, encodedPage, encodedPer_page, encodedFilter, encodedGrouped_ids, encodedTime_period, encodedReport_based_on, encodedView_id];
NSURL *url = [NSURL URLWithString:urlString];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
[request setHTTPMethod:@"GET"];
[request setValue:@"Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa" forHTTPHeaderField:@"Authorization"];

NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *task = [session dataTaskWithRequest:request
    completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
        NSString *result = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
        NSLog(@"%@", result);
}];
[task resume];

open Lwt
open Cohttp_lwt_unix

let () =
  let enc_project_id = Uri.pct_encode "23806000097545166" in
  let enc_from_date = Uri.pct_encode "2025-05-01T00:00:00.000Z" in
  let enc_to_date = Uri.pct_encode "2025-05-31T23:59:59.999Z" in
  let enc_index = Uri.pct_encode "1" in
  let enc_range = Uri.pct_encode "100" in
  let enc_page = Uri.pct_encode "1" in
  let enc_per_page = Uri.pct_encode "50" in
  let enc_filter = Uri.pct_encode "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}" in
  let enc_grouped_ids = Uri.pct_encode "[\"4000000002379\"]" in
  let enc_time_period = Uri.pct_encode "days" in
  let enc_report_based_on = Uri.pct_encode "users" in
  let enc_view_id = Uri.pct_encode "23806000074760021" in
  let uri = Uri.of_string ("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/details" ^ "?project_id=" ^ enc_project_id ^ "&from_date=" ^ enc_from_date ^ "&to_date=" ^ enc_to_date ^ "&index=" ^ enc_index ^ "&range=" ^ enc_range ^ "&page=" ^ enc_page ^ "&per_page=" ^ enc_per_page ^ "&filter=" ^ enc_filter ^ "&grouped_ids=" ^ enc_grouped_ids ^ "&time_period=" ^ enc_time_period ^ "&report_based_on=" ^ enc_report_based_on ^ "&view_id=" ^ enc_view_id) in
  let headers = Cohttp.Header.init ()
    |> fun h -> Cohttp.Header.add h "Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
  in
  Lwt_main.run (
    Client.get ~headers uri >>= fun (_, body) ->
    Cohttp_lwt.Body.to_string body >|= fun s ->
    print_endline s)

$headers = @{
    "Authorization" = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
}

$params = @{
    project_id = "23806000097545166"
    from_date = "2025-05-01T00:00:00.000Z"
    to_date = "2025-05-31T23:59:59.999Z"
    index = "1"
    range = "100"
    page = "1"
    per_page = "50"
    filter = "{`"criteria`":[{`"field_name`":`"project_id`",`"criteria_condition`":`"is`",`"value`":[`"23806000097545166`"]}],`"pattern`":`"1`"}"
    grouped_ids = "[`"4000000002379`"]"
    time_period = "days"
    report_based_on = "users"
    view_id = "23806000074760021"
}
$queryString = ($params.GetEnumerator() | ForEach-Object { "$($_.Key)=$([System.Uri]::EscapeDataString($_.Value))" }) -join "&"
$url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/details" + "?" + $queryString

$response = Invoke-RestMethod -Uri $url -Method GET -Headers $headers

$response | ConvertTo-Json

library(httr)

url <- "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/details"

params <- list(
  project_id = "23806000097545166",
  from_date = "2025-05-01T00:00:00.000Z",
  to_date = "2025-05-31T23:59:59.999Z",
  index = "1",
  range = "100",
  page = "1",
  per_page = "50",
  filter = "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}",
  grouped_ids = "[\"4000000002379\"]",
  time_period = "days",
  report_based_on = "users",
  view_id = "23806000074760021"
)

response <- GET(
  url,
  add_headers(Authorization = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"),
  query = params
)

content(response, "text")

import Foundation

var components = URLComponents(string: "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/details")!
components.queryItems = [
    URLQueryItem(name: "project_id", value: "23806000097545166"),
    URLQueryItem(name: "from_date", value: "2025-05-01T00:00:00.000Z"),
    URLQueryItem(name: "to_date", value: "2025-05-31T23:59:59.999Z"),
    URLQueryItem(name: "index", value: "1"),
    URLQueryItem(name: "range", value: "100"),
    URLQueryItem(name: "page", value: "1"),
    URLQueryItem(name: "per_page", value: "50"),
    URLQueryItem(name: "filter", value: "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}"),
    URLQueryItem(name: "grouped_ids", value: "[\"4000000002379\"]"),
    URLQueryItem(name: "time_period", value: "days"),
    URLQueryItem(name: "report_based_on", value: "users"),
    URLQueryItem(name: "view_id", value: "23806000074760021")
]
let url = components.url!
var request = URLRequest(url: url)
request.httpMethod = "GET"
request.setValue("Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa", forHTTPHeaderField: "Authorization")

let semaphore = DispatchSemaphore(value: 0)
let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data, let result = String(data: data, encoding: .utf8) {
        print(result)
    }
    semaphore.signal()
}
task.resume()
semaphore.wait()

Sample Input

project_id : "23806000097545166" from_date : "2025-05-01T00:00:00.000Z" to_date : "2025-05-31T23:59:59.999Z" index : "1" range : "100" page : 1 per_page : 50 filter : { "criteria" : [ { "field_name" : "project_id", "criteria_condition" : "is", "value" : [ "23806000097545166" ] } ], "pattern" : "1" } grouped_ids : ["4000000002379"] time_period : "days" report_based_on : "users" view_id : "23806000074760021"

Sample Response

200[ { "id" : "4000000549001", "entity_details" : [ { "id" : "4000000735001", "name" : "Network Throttle Test", "is_parent" : false, "custom_status_id" : "4000000000356", "start_date" : "2025-05-06 09:00", "end_date" : "2025-05-08 15:00", "duration" : "3", "percent_complete" : "0", "is_duration_work" : true, "is_closed" : false, "work_type" : "0", "is_cascade_work" : false, "item_number" : "WR1-T70", "day_work" : [ { "date" : "2025-05-06", "work" : "540" }, { "date" : "2025-05-08", "work" : "360" }, { "date" : "2025-05-07", "work" : "540" } ], "project_id" : "4000000303005", "duration_hours" : "24:0", "business_hour_id" : "4000000568047", "total_work" : "1440" } ] } ]

Get Workload Task Entity Details

Retrieve the workload details of a task from the Zoho Projects portal.

GET

/api/v3/portal/[PORTAL_ID]/reports/workload/entity/[ENTITY_ID]/details

OAuth Scope:

ZohoProjects.portals.READ

Path Parameters

Param Name

Data Type

Description

portal_id

String

required
regex : [0-9]+

Unique, immutable identifier of the portal in Zoho Projects. You can obtain it from the Get Portals API (the "id" field in the response).

entity_id

String

required
regex : [0-9]+

Identifier of an entity. Obtained from the Get Entities API - the "id" field in the response corresponds to entity_id.

Query Parameters

Param Name

Data Type

Description

project_id

int

Enter the project ID of the task. You can obtain it from the Get Projects API (the "id" field in the response).

from_date

String

Enter the start date of the chart.

to_date

String

Enter the end date of the chart.

report_based_on

String

regex : users|teams

Enter the report based on value.
Accepted values : users,teams

view_id

int

Enter the custom view ID.

Request Example

cURL
Deluge
Node.js
Ruby
PHP
- Python
- C
- C#
- C++
- Clojure
- Go
- HTTP
- Java
- JS Fetch
- JSON
- Kotlin
- Objective-C
- OCaml
- PowerShell
- R
- Swift

curl -X GET \
'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/entity/[ENTITY_ID]/details?project_id=23806000097545166&from_date=2025-05-01T00%3A00%3A00.000Z&to_date=2025-05-31T23%3A59%3A59.999Z&report_based_on=users&view_id=23806000074760021' \
-H 'Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/entity/[ENTITY_ID]/details";
params = Map();
params.put("project_id", "23806000097545166");
params.put("from_date", "2025-05-01T00:00:00.000Z");
params.put("to_date", "2025-05-31T23:59:59.999Z");
params.put("report_based_on", "users");
params.put("view_id", "23806000074760021");
response = invokeUrl
[
    url: url
    type: GET
    parameters: params
    connection: "projects"
];
info response;

const https = require('https');
const url = new URL('https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/entity/[ENTITY_ID]/details');
url.searchParams.append('project_id', '23806000097545166');
url.searchParams.append('from_date', '2025-05-01T00:00:00.000Z');
url.searchParams.append('to_date', '2025-05-31T23:59:59.999Z');
url.searchParams.append('report_based_on', 'users');
url.searchParams.append('view_id', '23806000074760021');

const options = {
  hostname: url.hostname,
  path: url.pathname + url.search,
  method: 'GET',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'
  }
};

const req = https.request(options, (res) => {
  let data = '';
  res.on('data', (chunk) => { data += chunk; });
  res.on('end', () => { console.log(JSON.parse(data)); });
});

req.on('error', (err) => { console.error(err); });
req.end();

require 'net/http'
require 'uri'
require 'json'

url = URI("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/entity/[ENTITY_ID]/details")
params = {
  "project_id" => "23806000097545166",
  "from_date" => "2025-05-01T00:00:00.000Z",
  "to_date" => "2025-05-31T23:59:59.999Z",
  "report_based_on" => "users",
  "view_id" => "23806000074760021"
}
url.query = URI.encode_www_form(params)

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"

response = http.request(request)
puts response.read_body

<?php
$params = [
    'project_id' => '23806000097545166',
    'from_date' => '2025-05-01T00:00:00.000Z',
    'to_date' => '2025-05-31T23:59:59.999Z',
    'report_based_on' => 'users',
    'view_id' => '23806000074760021',
];
$url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/entity/[ENTITY_ID]/details" . "?" . http_build_query($params);

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => $url,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

import requests

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/entity/[ENTITY_ID]/details"

params = {
    "project_id": "23806000097545166",
    "from_date": "2025-05-01T00:00:00.000Z",
    "to_date": "2025-05-31T23:59:59.999Z",
    "report_based_on": "users",
    "view_id": "23806000074760021"
}

headers = {
    "Authorization": "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa",
}

response = requests.get(url, headers=headers, params=params)

print(response.json())

#include <stdio.h>
#include <string.h>
#include <curl/curl.h>

int main(void) {
    CURL *curl = curl_easy_init();
    if (curl) {
        char *enc_project_id = curl_easy_escape(curl, "23806000097545166", 0);
        char *enc_from_date = curl_easy_escape(curl, "2025-05-01T00:00:00.000Z", 0);
        char *enc_to_date = curl_easy_escape(curl, "2025-05-31T23:59:59.999Z", 0);
        char *enc_report_based_on = curl_easy_escape(curl, "users", 0);
        char *enc_view_id = curl_easy_escape(curl, "23806000074760021", 0);
        char url[2048];
        snprintf(url, sizeof(url), "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/entity/[ENTITY_ID]/details?project_id=%s&from_date=%s&to_date=%s&report_based_on=%s&view_id=%s", enc_project_id, enc_from_date, enc_to_date, enc_report_based_on, enc_view_id);

        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

        curl_easy_setopt(curl, CURLOPT_URL, url);
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");

        CURLcode res = curl_easy_perform(curl);
        if (res != CURLE_OK)
            fprintf(stderr, "curl failed: %s\n", curl_easy_strerror(res));

        curl_free(enc_project_id);
        curl_free(enc_from_date);
        curl_free(enc_to_date);
        curl_free(enc_report_based_on);
        curl_free(enc_view_id);
        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

using System.Net.Http;
using System.Text;
using System.Web;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

var query = HttpUtility.ParseQueryString(string.Empty);
query["project_id"] = "23806000097545166";
query["from_date"] = "2025-05-01T00:00:00.000Z";
query["to_date"] = "2025-05-31T23:59:59.999Z";
query["report_based_on"] = "users";
query["view_id"] = "23806000074760021";
var uriBuilder = new UriBuilder("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/entity/[ENTITY_ID]/details") { Query = query.ToString() };
var request = new HttpRequestMessage(HttpMethod.Get, uriBuilder.Uri);

var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

#include <iostream>
#include <string>
#include <curl/curl.h>

static size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* output) {
    output->append((char*)contents, size * nmemb);
    return size * nmemb;
}

int main() {
    CURL* curl = curl_easy_init();
    if (curl) {
        std::string response;
        char* enc_project_id = curl_easy_escape(curl, "23806000097545166", 0);
        char* enc_from_date = curl_easy_escape(curl, "2025-05-01T00:00:00.000Z", 0);
        char* enc_to_date = curl_easy_escape(curl, "2025-05-31T23:59:59.999Z", 0);
        char* enc_report_based_on = curl_easy_escape(curl, "users", 0);
        char* enc_view_id = curl_easy_escape(curl, "23806000074760021", 0);
        std::string url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/entity/[ENTITY_ID]/details";
        url += "?project_id=" + std::string(enc_project_id);
        url += "&from_date=" + std::string(enc_from_date);
        url += "&to_date=" + std::string(enc_to_date);
        url += "&report_based_on=" + std::string(enc_report_based_on);
        url += "&view_id=" + std::string(enc_view_id);

        struct curl_slist* headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

        curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);

        CURLcode res = curl_easy_perform(curl);
        if (res == CURLE_OK)
            std::cout << response << std::endl;
        else
            std::cerr << curl_easy_strerror(res) << std::endl;

        curl_free(enc_project_id);
        curl_free(enc_from_date);
        curl_free(enc_to_date);
        curl_free(enc_report_based_on);
        curl_free(enc_view_id);
        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

(require '[clj-http.client :as client])

(let [enc-project_id (java.net.URLEncoder/encode "23806000097545166" "UTF-8")
      enc-from_date (java.net.URLEncoder/encode "2025-05-01T00:00:00.000Z" "UTF-8")
      enc-to_date (java.net.URLEncoder/encode "2025-05-31T23:59:59.999Z" "UTF-8")
      enc-report_based_on (java.net.URLEncoder/encode "users" "UTF-8")
      enc-view_id (java.net.URLEncoder/encode "23806000074760021" "UTF-8")
      url (str "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/entity/[ENTITY_ID]/details" "?project_id=" enc-project_id "&from_date=" enc-from_date "&to_date=" enc-to_date "&report_based_on=" enc-report_based_on "&view_id=" enc-view_id)]
(def response
  (client/get url
    {:headers {"Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"}
     :as :json}))

(println (:body response))

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
)

func main() {
    req, _ := http.NewRequest("GET", "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/entity/[ENTITY_ID]/details", nil)
    q := req.URL.Query()
    q.Add("project_id", "23806000097545166")
    q.Add("from_date", "2025-05-01T00:00:00.000Z")
    q.Add("to_date", "2025-05-31T23:59:59.999Z")
    q.Add("report_based_on", "users")
    q.Add("view_id", "23806000074760021")
    req.URL.RawQuery = q.Encode()
    req.Header.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

GET https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/entity/[ENTITY_ID]/details?project_id=23806000097545166&from_date=2025-05-01T00%3A00%3A00.000Z&to_date=2025-05-31T23%3A59%3A59.999Z&report_based_on=users&view_id=23806000074760021 HTTP/1.1
Host: https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/entity/[ENTITY_ID]/details?project_id=23806000097545166&from_date=2025-05-01T00%3A00%3A00.000Z&to_date=2025-05-31T23%3A59%3A59.999Z&report_based_on=users&view_id=23806000074760021
Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa

HttpClientBuilder httpClientBuilder = HttpClientBuilder.create();

SSLContext sslContext = SSLContext.getDefault();
SSLConnectionSocketFactory sslConnectionSocketFactory = new SSLConnectionSocketFactory(sslContext, NoopHostnameVerifier.INSTANCE);
CloseableHttpClient httpclient = httpClientBuilder.setSSLSocketFactory(sslConnectionSocketFactory).build();

URIBuilder uriBuilder = new URIBuilder("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/entity/[ENTITY_ID]/details");
uriBuilder.addParameter("project_id", "23806000097545166");
uriBuilder.addParameter("from_date", "2025-05-01T00:00:00.000Z");
uriBuilder.addParameter("to_date", "2025-05-31T23:59:59.999Z");
uriBuilder.addParameter("report_based_on", "users");
uriBuilder.addParameter("view_id", "23806000074760021");
HttpUriRequest requestObj = new HttpGet(uriBuilder.build());
requestObj.addHeader("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

HttpResponse response = httpclient.execute(requestObj);

HttpEntity responseEntity = response.getEntity();
Object responseObject = EntityUtils.toString(responseEntity);
String responseString = responseObject.toString();

const url = 'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/entity/[ENTITY_ID]/details';

const params = new URLSearchParams({
  'project_id': '23806000097545166',
  'from_date': '2025-05-01T00:00:00.000Z',
  'to_date': '2025-05-31T23:59:59.999Z',
  'report_based_on': 'users',
  'view_id': '23806000074760021'
});

const options = {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'
  }
};

fetch(url + '?' + params.toString(), options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error(error));

project_id = "23806000097545166"
from_date = "2025-05-01T00:00:00.000Z"
to_date = "2025-05-31T23:59:59.999Z"
report_based_on = "users"
view_id = "23806000074760021"

import java.net.HttpURLConnection
import java.net.URL
import okhttp3.HttpUrl.Companion.toHttpUrl

fun main() {
    val urlBuilder = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/entity/[ENTITY_ID]/details".toHttpUrl().newBuilder()
    urlBuilder.addQueryParameter("project_id", "23806000097545166")
    urlBuilder.addQueryParameter("from_date", "2025-05-01T00:00:00.000Z")
    urlBuilder.addQueryParameter("to_date", "2025-05-31T23:59:59.999Z")
    urlBuilder.addQueryParameter("report_based_on", "users")
    urlBuilder.addQueryParameter("view_id", "23806000074760021")
    val url = URL(urlBuilder.build().toString())
    val conn = url.openConnection() as HttpURLConnection
    conn.requestMethod = "GET"
    conn.setRequestProperty("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")

    val response = conn.inputStream.bufferedReader().readText()
    println(response)
}

NSString *encodedProject_id = [@"23806000097545166" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedFrom_date = [@"2025-05-01T00:00:00.000Z" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedTo_date = [@"2025-05-31T23:59:59.999Z" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedReport_based_on = [@"users" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedView_id = [@"23806000074760021" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *urlString = [NSString stringWithFormat:@"https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/entity/[ENTITY_ID]/details?project_id=%@&from_date=%@&to_date=%@&report_based_on=%@&view_id=%@", encodedProject_id, encodedFrom_date, encodedTo_date, encodedReport_based_on, encodedView_id];
NSURL *url = [NSURL URLWithString:urlString];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
[request setHTTPMethod:@"GET"];
[request setValue:@"Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa" forHTTPHeaderField:@"Authorization"];

NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *task = [session dataTaskWithRequest:request
    completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
        NSString *result = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
        NSLog(@"%@", result);
}];
[task resume];

open Lwt
open Cohttp_lwt_unix

let () =
  let enc_project_id = Uri.pct_encode "23806000097545166" in
  let enc_from_date = Uri.pct_encode "2025-05-01T00:00:00.000Z" in
  let enc_to_date = Uri.pct_encode "2025-05-31T23:59:59.999Z" in
  let enc_report_based_on = Uri.pct_encode "users" in
  let enc_view_id = Uri.pct_encode "23806000074760021" in
  let uri = Uri.of_string ("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/entity/[ENTITY_ID]/details" ^ "?project_id=" ^ enc_project_id ^ "&from_date=" ^ enc_from_date ^ "&to_date=" ^ enc_to_date ^ "&report_based_on=" ^ enc_report_based_on ^ "&view_id=" ^ enc_view_id) in
  let headers = Cohttp.Header.init ()
    |> fun h -> Cohttp.Header.add h "Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
  in
  Lwt_main.run (
    Client.get ~headers uri >>= fun (_, body) ->
    Cohttp_lwt.Body.to_string body >|= fun s ->
    print_endline s)

$headers = @{
    "Authorization" = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
}

$params = @{
    project_id = "23806000097545166"
    from_date = "2025-05-01T00:00:00.000Z"
    to_date = "2025-05-31T23:59:59.999Z"
    report_based_on = "users"
    view_id = "23806000074760021"
}
$queryString = ($params.GetEnumerator() | ForEach-Object { "$($_.Key)=$([System.Uri]::EscapeDataString($_.Value))" }) -join "&"
$url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/entity/[ENTITY_ID]/details" + "?" + $queryString

$response = Invoke-RestMethod -Uri $url -Method GET -Headers $headers

$response | ConvertTo-Json

library(httr)

url <- "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/entity/[ENTITY_ID]/details"

params <- list(
  project_id = "23806000097545166",
  from_date = "2025-05-01T00:00:00.000Z",
  to_date = "2025-05-31T23:59:59.999Z",
  report_based_on = "users",
  view_id = "23806000074760021"
)

response <- GET(
  url,
  add_headers(Authorization = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"),
  query = params
)

content(response, "text")

import Foundation

var components = URLComponents(string: "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/entity/[ENTITY_ID]/details")!
components.queryItems = [
    URLQueryItem(name: "project_id", value: "23806000097545166"),
    URLQueryItem(name: "from_date", value: "2025-05-01T00:00:00.000Z"),
    URLQueryItem(name: "to_date", value: "2025-05-31T23:59:59.999Z"),
    URLQueryItem(name: "report_based_on", value: "users"),
    URLQueryItem(name: "view_id", value: "23806000074760021")
]
let url = components.url!
var request = URLRequest(url: url)
request.httpMethod = "GET"
request.setValue("Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa", forHTTPHeaderField: "Authorization")

let semaphore = DispatchSemaphore(value: 0)
let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data, let result = String(data: data, encoding: .utf8) {
        print(result)
    }
    semaphore.signal()
}
task.resume()
semaphore.wait()

Sample Input

project_id : "23806000097545166" from_date : "2025-05-01T00:00:00.000Z" to_date : "2025-05-31T23:59:59.999Z" report_based_on : "users" view_id : "23806000074760021"

Sample Response

200[ { "id" : "4000001068022", "entity_details" : [ { "id" : "4000000735001", "name" : "Network Throttle Test", "is_parent" : false, "custom_status_id" : "4000000000356", "start_date" : "2025-05-06 09:00", "end_date" : "2025-05-08 15:00", "duration" : "3", "percent_complete" : "0", "is_duration_work" : true, "is_closed" : false, "work_type" : "0", "is_cascade_work" : false, "item_number" : "WR1-T70", "day_work" : [ { "date" : "2025-05-06", "work" : "540" }, { "date" : "2025-05-08", "work" : "360" }, { "date" : "2025-05-07", "work" : "540" } ], "project_id" : "4000000303005", "duration_hours" : "24:0", "business_hour_id" : "4000000568047", "total_work" : "1440" } ] } ]

Get Workload Report Groups

Retrieve the groups from the workload report. When a Group By option is selected, records are organized under the selected group. Use this API to fetch these groups, apply filters, and configure the time range for global or project-specific reports.

GET

/api/v3/portal/[PORTAL_ID]/reports/workload/groups

OAuth Scope:

ZohoProjects.portals.READ

Path Parameters

Param Name

Data Type

Description

portal_id

String

required
regex : [0-9]+

Unique, immutable identifier of the portal in Zoho Projects. You can obtain it from the Get Portals API (the "id" field in the response).

Query Parameters

Param Name

Data Type

Description

project_id

int

Enter the project ID (Not required for global reports).

from_date

String

Enter the start date of the chart.

to_date

String

Enter the end date of the chart.

time_period

String

regex : days|weeks|months

Enter the view period.
Accepted values : days,weeks,months

group_by

JSONObject

Specify the grouping criteria for the report data.

index

int

Enter the index of the record.

range

int

Enter the range of the record.

page

int

Enter the page number to retrieve.

per_page

int

Enter the number of entries to display per page.

filter

JSONObject

Enter the filter criteria to narrow down results.

search_term

String

Enter the search term to look up specific records.

view_id

int

required

Enter the custom view ID.

Request Example

cURL
Deluge
Node.js
Ruby
PHP
- Python
- C
- C#
- C++
- Clojure
- Go
- HTTP
- Java
- JS Fetch
- JSON
- Kotlin
- Objective-C
- OCaml
- PowerShell
- R
- Swift

curl -X GET \
'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups?project_id=23806000097545166&from_date=2025-05-01T00%3A00%3A00.000Z&to_date=2025-05-31T23%3A59%3A59.999Z&time_period=days&group_by=%7B%22field_name%22%3A%22project_id%22%2C%22module%22%3A%22-%22%2C%22sort_by%22%3A%22-%22%7D&index=1&range=15&page=1&per_page=10&filter=%7B%22criteria%22%3A%5B%7B%22field_name%22%3A%22project_id%22%2C%22criteria_condition%22%3A%22is%22%2C%22value%22%3A%5B%2223806000097545166%22%5D%7D%5D%2C%22pattern%22%3A%221%22%7D&search_term=Zoho+Projects&view_id=23806000074760021' \
-H 'Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups";
group_by_value = {"field_name":"project_id","module":"-","sort_by":"-"};
filter_value = {"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"};
params = Map();
params.put("project_id", "23806000097545166");
params.put("from_date", "2025-05-01T00:00:00.000Z");
params.put("to_date", "2025-05-31T23:59:59.999Z");
params.put("time_period", "days");
params.put("group_by", group_by_value);
params.put("index", 1);
params.put("range", 15);
params.put("page", "1");
params.put("per_page", "10");
params.put("filter", filter_value);
params.put("search_term", "Zoho Projects");
params.put("view_id", "23806000074760021");
response = invokeUrl
[
    url: url
    type: GET
    parameters: params
    connection: "projects"
];
info response;

const https = require('https');
const url = new URL('https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups');
url.searchParams.append('project_id', '23806000097545166');
url.searchParams.append('from_date', '2025-05-01T00:00:00.000Z');
url.searchParams.append('to_date', '2025-05-31T23:59:59.999Z');
url.searchParams.append('time_period', 'days');
url.searchParams.append('group_by', '{"field_name":"project_id","module":"-","sort_by":"-"}');
url.searchParams.append('index', '1');
url.searchParams.append('range', '15');
url.searchParams.append('page', '1');
url.searchParams.append('per_page', '10');
url.searchParams.append('filter', '{"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"}');
url.searchParams.append('search_term', 'Zoho Projects');
url.searchParams.append('view_id', '23806000074760021');

const options = {
  hostname: url.hostname,
  path: url.pathname + url.search,
  method: 'GET',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'
  }
};

const req = https.request(options, (res) => {
  let data = '';
  res.on('data', (chunk) => { data += chunk; });
  res.on('end', () => { console.log(JSON.parse(data)); });
});

req.on('error', (err) => { console.error(err); });
req.end();

require 'net/http'
require 'uri'
require 'json'

url = URI("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups")
params = {
  "project_id" => "23806000097545166",
  "from_date" => "2025-05-01T00:00:00.000Z",
  "to_date" => "2025-05-31T23:59:59.999Z",
  "time_period" => "days",
  "group_by" => "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}",
  "index" => "1",
  "range" => "15",
  "page" => "1",
  "per_page" => "10",
  "filter" => "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}",
  "search_term" => "Zoho Projects",
  "view_id" => "23806000074760021"
}
url.query = URI.encode_www_form(params)

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"

response = http.request(request)
puts response.read_body

<?php
$params = [
    'project_id' => '23806000097545166',
    'from_date' => '2025-05-01T00:00:00.000Z',
    'to_date' => '2025-05-31T23:59:59.999Z',
    'time_period' => 'days',
    'group_by' => '{"field_name":"project_id","module":"-","sort_by":"-"}',
    'index' => '1',
    'range' => '15',
    'page' => '1',
    'per_page' => '10',
    'filter' => '{"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"}',
    'search_term' => 'Zoho Projects',
    'view_id' => '23806000074760021',
];
$url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups" . "?" . http_build_query($params);

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => $url,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

import requests

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups"

params = {
    "project_id": "23806000097545166",
    "from_date": "2025-05-01T00:00:00.000Z",
    "to_date": "2025-05-31T23:59:59.999Z",
    "time_period": "days",
    "group_by": "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}",
    "index": "1",
    "range": "15",
    "page": "1",
    "per_page": "10",
    "filter": "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}",
    "search_term": "Zoho Projects",
    "view_id": "23806000074760021"
}

headers = {
    "Authorization": "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa",
}

response = requests.get(url, headers=headers, params=params)

print(response.json())

#include <stdio.h>
#include <string.h>
#include <curl/curl.h>

int main(void) {
    CURL *curl = curl_easy_init();
    if (curl) {
        char *enc_project_id = curl_easy_escape(curl, "23806000097545166", 0);
        char *enc_from_date = curl_easy_escape(curl, "2025-05-01T00:00:00.000Z", 0);
        char *enc_to_date = curl_easy_escape(curl, "2025-05-31T23:59:59.999Z", 0);
        char *enc_time_period = curl_easy_escape(curl, "days", 0);
        char *enc_group_by = curl_easy_escape(curl, "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}", 0);
        char *enc_index = curl_easy_escape(curl, "1", 0);
        char *enc_range = curl_easy_escape(curl, "15", 0);
        char *enc_page = curl_easy_escape(curl, "1", 0);
        char *enc_per_page = curl_easy_escape(curl, "10", 0);
        char *enc_filter = curl_easy_escape(curl, "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}", 0);
        char *enc_search_term = curl_easy_escape(curl, "Zoho Projects", 0);
        char *enc_view_id = curl_easy_escape(curl, "23806000074760021", 0);
        char url[2048];
        snprintf(url, sizeof(url), "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups?project_id=%s&from_date=%s&to_date=%s&time_period=%s&group_by=%s&index=%s&range=%s&page=%s&per_page=%s&filter=%s&search_term=%s&view_id=%s", enc_project_id, enc_from_date, enc_to_date, enc_time_period, enc_group_by, enc_index, enc_range, enc_page, enc_per_page, enc_filter, enc_search_term, enc_view_id);

        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

        curl_easy_setopt(curl, CURLOPT_URL, url);
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");

        CURLcode res = curl_easy_perform(curl);
        if (res != CURLE_OK)
            fprintf(stderr, "curl failed: %s\n", curl_easy_strerror(res));

        curl_free(enc_project_id);
        curl_free(enc_from_date);
        curl_free(enc_to_date);
        curl_free(enc_time_period);
        curl_free(enc_group_by);
        curl_free(enc_index);
        curl_free(enc_range);
        curl_free(enc_page);
        curl_free(enc_per_page);
        curl_free(enc_filter);
        curl_free(enc_search_term);
        curl_free(enc_view_id);
        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

using System.Net.Http;
using System.Text;
using System.Web;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

var query = HttpUtility.ParseQueryString(string.Empty);
query["project_id"] = "23806000097545166";
query["from_date"] = "2025-05-01T00:00:00.000Z";
query["to_date"] = "2025-05-31T23:59:59.999Z";
query["time_period"] = "days";
query["group_by"] = "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}";
query["index"] = "1";
query["range"] = "15";
query["page"] = "1";
query["per_page"] = "10";
query["filter"] = "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}";
query["search_term"] = "Zoho Projects";
query["view_id"] = "23806000074760021";
var uriBuilder = new UriBuilder("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups") { Query = query.ToString() };
var request = new HttpRequestMessage(HttpMethod.Get, uriBuilder.Uri);

var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

#include <iostream>
#include <string>
#include <curl/curl.h>

static size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* output) {
    output->append((char*)contents, size * nmemb);
    return size * nmemb;
}

int main() {
    CURL* curl = curl_easy_init();
    if (curl) {
        std::string response;
        char* enc_project_id = curl_easy_escape(curl, "23806000097545166", 0);
        char* enc_from_date = curl_easy_escape(curl, "2025-05-01T00:00:00.000Z", 0);
        char* enc_to_date = curl_easy_escape(curl, "2025-05-31T23:59:59.999Z", 0);
        char* enc_time_period = curl_easy_escape(curl, "days", 0);
        char* enc_group_by = curl_easy_escape(curl, "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}", 0);
        char* enc_index = curl_easy_escape(curl, "1", 0);
        char* enc_range = curl_easy_escape(curl, "15", 0);
        char* enc_page = curl_easy_escape(curl, "1", 0);
        char* enc_per_page = curl_easy_escape(curl, "10", 0);
        char* enc_filter = curl_easy_escape(curl, "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}", 0);
        char* enc_search_term = curl_easy_escape(curl, "Zoho Projects", 0);
        char* enc_view_id = curl_easy_escape(curl, "23806000074760021", 0);
        std::string url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups";
        url += "?project_id=" + std::string(enc_project_id);
        url += "&from_date=" + std::string(enc_from_date);
        url += "&to_date=" + std::string(enc_to_date);
        url += "&time_period=" + std::string(enc_time_period);
        url += "&group_by=" + std::string(enc_group_by);
        url += "&index=" + std::string(enc_index);
        url += "&range=" + std::string(enc_range);
        url += "&page=" + std::string(enc_page);
        url += "&per_page=" + std::string(enc_per_page);
        url += "&filter=" + std::string(enc_filter);
        url += "&search_term=" + std::string(enc_search_term);
        url += "&view_id=" + std::string(enc_view_id);

        struct curl_slist* headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

        curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);

        CURLcode res = curl_easy_perform(curl);
        if (res == CURLE_OK)
            std::cout << response << std::endl;
        else
            std::cerr << curl_easy_strerror(res) << std::endl;

        curl_free(enc_project_id);
        curl_free(enc_from_date);
        curl_free(enc_to_date);
        curl_free(enc_time_period);
        curl_free(enc_group_by);
        curl_free(enc_index);
        curl_free(enc_range);
        curl_free(enc_page);
        curl_free(enc_per_page);
        curl_free(enc_filter);
        curl_free(enc_search_term);
        curl_free(enc_view_id);
        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

(require '[clj-http.client :as client])

(let [enc-project_id (java.net.URLEncoder/encode "23806000097545166" "UTF-8")
      enc-from_date (java.net.URLEncoder/encode "2025-05-01T00:00:00.000Z" "UTF-8")
      enc-to_date (java.net.URLEncoder/encode "2025-05-31T23:59:59.999Z" "UTF-8")
      enc-time_period (java.net.URLEncoder/encode "days" "UTF-8")
      enc-group_by (java.net.URLEncoder/encode "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}" "UTF-8")
      enc-index (java.net.URLEncoder/encode "1" "UTF-8")
      enc-range (java.net.URLEncoder/encode "15" "UTF-8")
      enc-page (java.net.URLEncoder/encode "1" "UTF-8")
      enc-per_page (java.net.URLEncoder/encode "10" "UTF-8")
      enc-filter (java.net.URLEncoder/encode "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}" "UTF-8")
      enc-search_term (java.net.URLEncoder/encode "Zoho Projects" "UTF-8")
      enc-view_id (java.net.URLEncoder/encode "23806000074760021" "UTF-8")
      url (str "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups" "?project_id=" enc-project_id "&from_date=" enc-from_date "&to_date=" enc-to_date "&time_period=" enc-time_period "&group_by=" enc-group_by "&index=" enc-index "&range=" enc-range "&page=" enc-page "&per_page=" enc-per_page "&filter=" enc-filter "&search_term=" enc-search_term "&view_id=" enc-view_id)]
(def response
  (client/get url
    {:headers {"Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"}
     :as :json}))

(println (:body response))

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
)

func main() {
    req, _ := http.NewRequest("GET", "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups", nil)
    q := req.URL.Query()
    q.Add("project_id", "23806000097545166")
    q.Add("from_date", "2025-05-01T00:00:00.000Z")
    q.Add("to_date", "2025-05-31T23:59:59.999Z")
    q.Add("time_period", "days")
    q.Add("group_by", "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}")
    q.Add("index", "1")
    q.Add("range", "15")
    q.Add("page", "1")
    q.Add("per_page", "10")
    q.Add("filter", "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}")
    q.Add("search_term", "Zoho Projects")
    q.Add("view_id", "23806000074760021")
    req.URL.RawQuery = q.Encode()
    req.Header.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

GET https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups?project_id=23806000097545166&from_date=2025-05-01T00%3A00%3A00.000Z&to_date=2025-05-31T23%3A59%3A59.999Z&time_period=days&group_by=%7B%22field_name%22%3A%22project_id%22%2C%22module%22%3A%22-%22%2C%22sort_by%22%3A%22-%22%7D&index=1&range=15&page=1&per_page=10&filter=%7B%22criteria%22%3A%5B%7B%22field_name%22%3A%22project_id%22%2C%22criteria_condition%22%3A%22is%22%2C%22value%22%3A%5B%2223806000097545166%22%5D%7D%5D%2C%22pattern%22%3A%221%22%7D&search_term=Zoho+Projects&view_id=23806000074760021 HTTP/1.1
Host: https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups?project_id=23806000097545166&from_date=2025-05-01T00%3A00%3A00.000Z&to_date=2025-05-31T23%3A59%3A59.999Z&time_period=days&group_by=%7B%22field_name%22%3A%22project_id%22%2C%22module%22%3A%22-%22%2C%22sort_by%22%3A%22-%22%7D&index=1&range=15&page=1&per_page=10&filter=%7B%22criteria%22%3A%5B%7B%22field_name%22%3A%22project_id%22%2C%22criteria_condition%22%3A%22is%22%2C%22value%22%3A%5B%2223806000097545166%22%5D%7D%5D%2C%22pattern%22%3A%221%22%7D&search_term=Zoho+Projects&view_id=23806000074760021
Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa

HttpClientBuilder httpClientBuilder = HttpClientBuilder.create();

SSLContext sslContext = SSLContext.getDefault();
SSLConnectionSocketFactory sslConnectionSocketFactory = new SSLConnectionSocketFactory(sslContext, NoopHostnameVerifier.INSTANCE);
CloseableHttpClient httpclient = httpClientBuilder.setSSLSocketFactory(sslConnectionSocketFactory).build();

URIBuilder uriBuilder = new URIBuilder("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups");
uriBuilder.addParameter("project_id", "23806000097545166");
uriBuilder.addParameter("from_date", "2025-05-01T00:00:00.000Z");
uriBuilder.addParameter("to_date", "2025-05-31T23:59:59.999Z");
uriBuilder.addParameter("time_period", "days");
uriBuilder.addParameter("group_by", "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}");
uriBuilder.addParameter("index", "1");
uriBuilder.addParameter("range", "15");
uriBuilder.addParameter("page", "1");
uriBuilder.addParameter("per_page", "10");
uriBuilder.addParameter("filter", "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}");
uriBuilder.addParameter("search_term", "Zoho Projects");
uriBuilder.addParameter("view_id", "23806000074760021");
HttpUriRequest requestObj = new HttpGet(uriBuilder.build());
requestObj.addHeader("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

HttpResponse response = httpclient.execute(requestObj);

HttpEntity responseEntity = response.getEntity();
Object responseObject = EntityUtils.toString(responseEntity);
String responseString = responseObject.toString();

const url = 'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups';

const params = new URLSearchParams({
  'project_id': '23806000097545166',
  'from_date': '2025-05-01T00:00:00.000Z',
  'to_date': '2025-05-31T23:59:59.999Z',
  'time_period': 'days',
  'group_by': '{"field_name":"project_id","module":"-","sort_by":"-"}',
  'index': '1',
  'range': '15',
  'page': '1',
  'per_page': '10',
  'filter': '{"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"}',
  'search_term': 'Zoho Projects',
  'view_id': '23806000074760021'
});

const options = {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'
  }
};

fetch(url + '?' + params.toString(), options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error(error));

project_id = "23806000097545166"
from_date = "2025-05-01T00:00:00.000Z"
to_date = "2025-05-31T23:59:59.999Z"
time_period = "days"
group_by = {"field_name":"project_id","module":"-","sort_by":"-"}
index = 1
range = 15
page = "1"
per_page = "10"
filter = {"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"}
search_term = "Zoho Projects"
view_id = "23806000074760021"

import java.net.HttpURLConnection
import java.net.URL
import okhttp3.HttpUrl.Companion.toHttpUrl

fun main() {
    val urlBuilder = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups".toHttpUrl().newBuilder()
    urlBuilder.addQueryParameter("project_id", "23806000097545166")
    urlBuilder.addQueryParameter("from_date", "2025-05-01T00:00:00.000Z")
    urlBuilder.addQueryParameter("to_date", "2025-05-31T23:59:59.999Z")
    urlBuilder.addQueryParameter("time_period", "days")
    urlBuilder.addQueryParameter("group_by", "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}")
    urlBuilder.addQueryParameter("index", "1")
    urlBuilder.addQueryParameter("range", "15")
    urlBuilder.addQueryParameter("page", "1")
    urlBuilder.addQueryParameter("per_page", "10")
    urlBuilder.addQueryParameter("filter", "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}")
    urlBuilder.addQueryParameter("search_term", "Zoho Projects")
    urlBuilder.addQueryParameter("view_id", "23806000074760021")
    val url = URL(urlBuilder.build().toString())
    val conn = url.openConnection() as HttpURLConnection
    conn.requestMethod = "GET"
    conn.setRequestProperty("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")

    val response = conn.inputStream.bufferedReader().readText()
    println(response)
}

NSString *encodedProject_id = [@"23806000097545166" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedFrom_date = [@"2025-05-01T00:00:00.000Z" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedTo_date = [@"2025-05-31T23:59:59.999Z" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedTime_period = [@"days" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedGroup_by = [@"{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedIndex = [@"1" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedRange = [@"15" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedPage = [@"1" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedPer_page = [@"10" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedFilter = [@"{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedSearch_term = [@"Zoho Projects" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedView_id = [@"23806000074760021" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *urlString = [NSString stringWithFormat:@"https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups?project_id=%@&from_date=%@&to_date=%@&time_period=%@&group_by=%@&index=%@&range=%@&page=%@&per_page=%@&filter=%@&search_term=%@&view_id=%@", encodedProject_id, encodedFrom_date, encodedTo_date, encodedTime_period, encodedGroup_by, encodedIndex, encodedRange, encodedPage, encodedPer_page, encodedFilter, encodedSearch_term, encodedView_id];
NSURL *url = [NSURL URLWithString:urlString];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
[request setHTTPMethod:@"GET"];
[request setValue:@"Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa" forHTTPHeaderField:@"Authorization"];

NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *task = [session dataTaskWithRequest:request
    completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
        NSString *result = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
        NSLog(@"%@", result);
}];
[task resume];

open Lwt
open Cohttp_lwt_unix

let () =
  let enc_project_id = Uri.pct_encode "23806000097545166" in
  let enc_from_date = Uri.pct_encode "2025-05-01T00:00:00.000Z" in
  let enc_to_date = Uri.pct_encode "2025-05-31T23:59:59.999Z" in
  let enc_time_period = Uri.pct_encode "days" in
  let enc_group_by = Uri.pct_encode "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}" in
  let enc_index = Uri.pct_encode "1" in
  let enc_range = Uri.pct_encode "15" in
  let enc_page = Uri.pct_encode "1" in
  let enc_per_page = Uri.pct_encode "10" in
  let enc_filter = Uri.pct_encode "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}" in
  let enc_search_term = Uri.pct_encode "Zoho Projects" in
  let enc_view_id = Uri.pct_encode "23806000074760021" in
  let uri = Uri.of_string ("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups" ^ "?project_id=" ^ enc_project_id ^ "&from_date=" ^ enc_from_date ^ "&to_date=" ^ enc_to_date ^ "&time_period=" ^ enc_time_period ^ "&group_by=" ^ enc_group_by ^ "&index=" ^ enc_index ^ "&range=" ^ enc_range ^ "&page=" ^ enc_page ^ "&per_page=" ^ enc_per_page ^ "&filter=" ^ enc_filter ^ "&search_term=" ^ enc_search_term ^ "&view_id=" ^ enc_view_id) in
  let headers = Cohttp.Header.init ()
    |> fun h -> Cohttp.Header.add h "Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
  in
  Lwt_main.run (
    Client.get ~headers uri >>= fun (_, body) ->
    Cohttp_lwt.Body.to_string body >|= fun s ->
    print_endline s)

$headers = @{
    "Authorization" = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
}

$params = @{
    project_id = "23806000097545166"
    from_date = "2025-05-01T00:00:00.000Z"
    to_date = "2025-05-31T23:59:59.999Z"
    time_period = "days"
    group_by = "{`"field_name`":`"project_id`",`"module`":`"-`",`"sort_by`":`"-`"}"
    index = "1"
    range = "15"
    page = "1"
    per_page = "10"
    filter = "{`"criteria`":[{`"field_name`":`"project_id`",`"criteria_condition`":`"is`",`"value`":[`"23806000097545166`"]}],`"pattern`":`"1`"}"
    search_term = "Zoho Projects"
    view_id = "23806000074760021"
}
$queryString = ($params.GetEnumerator() | ForEach-Object { "$($_.Key)=$([System.Uri]::EscapeDataString($_.Value))" }) -join "&"
$url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups" + "?" + $queryString

$response = Invoke-RestMethod -Uri $url -Method GET -Headers $headers

$response | ConvertTo-Json

library(httr)

url <- "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups"

params <- list(
  project_id = "23806000097545166",
  from_date = "2025-05-01T00:00:00.000Z",
  to_date = "2025-05-31T23:59:59.999Z",
  time_period = "days",
  group_by = "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}",
  index = "1",
  range = "15",
  page = "1",
  per_page = "10",
  filter = "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}",
  search_term = "Zoho Projects",
  view_id = "23806000074760021"
)

response <- GET(
  url,
  add_headers(Authorization = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"),
  query = params
)

content(response, "text")

import Foundation

var components = URLComponents(string: "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups")!
components.queryItems = [
    URLQueryItem(name: "project_id", value: "23806000097545166"),
    URLQueryItem(name: "from_date", value: "2025-05-01T00:00:00.000Z"),
    URLQueryItem(name: "to_date", value: "2025-05-31T23:59:59.999Z"),
    URLQueryItem(name: "time_period", value: "days"),
    URLQueryItem(name: "group_by", value: "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}"),
    URLQueryItem(name: "index", value: "1"),
    URLQueryItem(name: "range", value: "15"),
    URLQueryItem(name: "page", value: "1"),
    URLQueryItem(name: "per_page", value: "10"),
    URLQueryItem(name: "filter", value: "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}"),
    URLQueryItem(name: "search_term", value: "Zoho Projects"),
    URLQueryItem(name: "view_id", value: "23806000074760021")
]
let url = components.url!
var request = URLRequest(url: url)
request.httpMethod = "GET"
request.setValue("Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa", forHTTPHeaderField: "Authorization")

let semaphore = DispatchSemaphore(value: 0)
let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data, let result = String(data: data, encoding: .utf8) {
        print(result)
    }
    semaphore.signal()
}
task.resume()
semaphore.wait()

Sample Input

Sample Response

200{ "parents" : [ { "secondary_id" : "2", "name" : "Admin", "associated_user_count" : 1, "id" : "4000000002505", "is_resource" : false } ] }

Get Records in a Group

Retrieve the list of records that belong to a specific group in the workload report. Use this API to fetch user, team, profile or role-level workload data, apply filters, and paginate through results for a specific group.

GET

/api/v3/portal/[PORTAL_ID]/reports/workload/groups/[GROUP_ID]/owners

OAuth Scope:

ZohoProjects.portals.READ

Path Parameters

Param Name

Data Type

Description

portal_id

String

required
regex : [0-9]+

Unique, immutable identifier of the portal in Zoho Projects. You can obtain it from the Get Portals API (the "id" field in the response).

group_id

String

required
regex : [0-9]+

Identifier of a group in the workload report. You can obtain it from the Get Workload Report Groups API (the "id" field in the response).

Query Parameters

Param Name

Data Type

Description

project_id

int

Enter the project ID (Not required for global reports).

from_date

String

Enter the start date of the chart.

to_date

String

Enter the end date of the chart.

time_period

String

regex : days|weeks|months

Enter the view period.
Accepted values : days,weeks,months

group_by

JSONObject

required

Specify the grouping criteria for the report data.

filter

JSONObject

Enter the filter criteria to narrow down results.

search_term

String

Enter the search term to look up specific records.

view_id

int

Enter the custom view ID.

next_token

String

Enter the token to fetch the next set of owners.

Request Example

cURL
Deluge
Node.js
Ruby
PHP
- Python
- C
- C#
- C++
- Clojure
- Go
- HTTP
- Java
- JS Fetch
- JSON
- Kotlin
- Objective-C
- OCaml
- PowerShell
- R
- Swift

curl -X GET \
'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/[GROUP_ID]/owners?project_id=23806000097545166&from_date=2025-05-01T00%3A00%3A00.000Z&to_date=2025-05-31T23%3A59%3A59.999Z&time_period=days&group_by=%7B%22field_name%22%3A%22project_id%22%2C%22module%22%3A%22-%22%2C%22sort_by%22%3A%22-%22%7D&filter=%7B%22criteria%22%3A%5B%7B%22field_name%22%3A%22project_id%22%2C%22criteria_condition%22%3A%22is%22%2C%22value%22%3A%5B%2223806000097545166%22%5D%7D%5D%2C%22pattern%22%3A%221%22%7D&search_term=Zoho+Projects&view_id=23806000074760021&next_token=projects-99de5bbbfd5a29869a95cc2a0c02730fe77b9cf67ad2b7f5800445cc01583e26a8580a97622e7ff88dda837ef21ad24fb97e6eb8f06f1f41feb9761a201d3b9ba4939b375b5935c2cddd7d8b54654b32cce38d47db390c7cafba052fadb82f1d60d558b829611462a000a25c9cdf1e2d4f8eadd6eef30e3b7c802c807fc2c59672c30a75650e3621d53708e3d4ec738805a576354d47dd305db1756ca576a8da131c8d8042bf7eaf8d5464ac275f1a8ba9a70474deaa7f8809578e7bcc82706a11cef928393829993cdb62c0a89fa637' \
-H 'Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/[GROUP_ID]/owners";
group_by_value = {"field_name":"project_id","module":"-","sort_by":"-"};
filter_value = {"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"};
params = Map();
params.put("project_id", "23806000097545166");
params.put("from_date", "2025-05-01T00:00:00.000Z");
params.put("to_date", "2025-05-31T23:59:59.999Z");
params.put("time_period", "days");
params.put("group_by", group_by_value);
params.put("filter", filter_value);
params.put("search_term", "Zoho Projects");
params.put("view_id", "23806000074760021");
params.put("next_token", "projects-99de5bbbfd5a29869a95cc2a0c02730fe77b9cf67ad2b7f5800445cc01583e26a8580a97622e7ff88dda837ef21ad24fb97e6eb8f06f1f41feb9761a201d3b9ba4939b375b5935c2cddd7d8b54654b32cce38d47db390c7cafba052fadb82f1d60d558b829611462a000a25c9cdf1e2d4f8eadd6eef30e3b7c802c807fc2c59672c30a75650e3621d53708e3d4ec738805a576354d47dd305db1756ca576a8da131c8d8042bf7eaf8d5464ac275f1a8ba9a70474deaa7f8809578e7bcc82706a11cef928393829993cdb62c0a89fa637");
response = invokeUrl
[
    url: url
    type: GET
    parameters: params
    connection: "projects"
];
info response;

const https = require('https');
const url = new URL('https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/[GROUP_ID]/owners');
url.searchParams.append('project_id', '23806000097545166');
url.searchParams.append('from_date', '2025-05-01T00:00:00.000Z');
url.searchParams.append('to_date', '2025-05-31T23:59:59.999Z');
url.searchParams.append('time_period', 'days');
url.searchParams.append('group_by', '{"field_name":"project_id","module":"-","sort_by":"-"}');
url.searchParams.append('filter', '{"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"}');
url.searchParams.append('search_term', 'Zoho Projects');
url.searchParams.append('view_id', '23806000074760021');
url.searchParams.append('next_token', 'projects-99de5bbbfd5a29869a95cc2a0c02730fe77b9cf67ad2b7f5800445cc01583e26a8580a97622e7ff88dda837ef21ad24fb97e6eb8f06f1f41feb9761a201d3b9ba4939b375b5935c2cddd7d8b54654b32cce38d47db390c7cafba052fadb82f1d60d558b829611462a000a25c9cdf1e2d4f8eadd6eef30e3b7c802c807fc2c59672c30a75650e3621d53708e3d4ec738805a576354d47dd305db1756ca576a8da131c8d8042bf7eaf8d5464ac275f1a8ba9a70474deaa7f8809578e7bcc82706a11cef928393829993cdb62c0a89fa637');

const options = {
  hostname: url.hostname,
  path: url.pathname + url.search,
  method: 'GET',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'
  }
};

const req = https.request(options, (res) => {
  let data = '';
  res.on('data', (chunk) => { data += chunk; });
  res.on('end', () => { console.log(JSON.parse(data)); });
});

req.on('error', (err) => { console.error(err); });
req.end();

require 'net/http'
require 'uri'
require 'json'

url = URI("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/[GROUP_ID]/owners")
params = {
  "project_id" => "23806000097545166",
  "from_date" => "2025-05-01T00:00:00.000Z",
  "to_date" => "2025-05-31T23:59:59.999Z",
  "time_period" => "days",
  "group_by" => "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}",
  "filter" => "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}",
  "search_term" => "Zoho Projects",
  "view_id" => "23806000074760021",
  "next_token" => "projects-99de5bbbfd5a29869a95cc2a0c02730fe77b9cf67ad2b7f5800445cc01583e26a8580a97622e7ff88dda837ef21ad24fb97e6eb8f06f1f41feb9761a201d3b9ba4939b375b5935c2cddd7d8b54654b32cce38d47db390c7cafba052fadb82f1d60d558b829611462a000a25c9cdf1e2d4f8eadd6eef30e3b7c802c807fc2c59672c30a75650e3621d53708e3d4ec738805a576354d47dd305db1756ca576a8da131c8d8042bf7eaf8d5464ac275f1a8ba9a70474deaa7f8809578e7bcc82706a11cef928393829993cdb62c0a89fa637"
}
url.query = URI.encode_www_form(params)

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"

response = http.request(request)
puts response.read_body

<?php
$params = [
    'project_id' => '23806000097545166',
    'from_date' => '2025-05-01T00:00:00.000Z',
    'to_date' => '2025-05-31T23:59:59.999Z',
    'time_period' => 'days',
    'group_by' => '{"field_name":"project_id","module":"-","sort_by":"-"}',
    'filter' => '{"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"}',
    'search_term' => 'Zoho Projects',
    'view_id' => '23806000074760021',
    'next_token' => 'projects-99de5bbbfd5a29869a95cc2a0c02730fe77b9cf67ad2b7f5800445cc01583e26a8580a97622e7ff88dda837ef21ad24fb97e6eb8f06f1f41feb9761a201d3b9ba4939b375b5935c2cddd7d8b54654b32cce38d47db390c7cafba052fadb82f1d60d558b829611462a000a25c9cdf1e2d4f8eadd6eef30e3b7c802c807fc2c59672c30a75650e3621d53708e3d4ec738805a576354d47dd305db1756ca576a8da131c8d8042bf7eaf8d5464ac275f1a8ba9a70474deaa7f8809578e7bcc82706a11cef928393829993cdb62c0a89fa637',
];
$url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/[GROUP_ID]/owners" . "?" . http_build_query($params);

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => $url,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

import requests

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/[GROUP_ID]/owners"

params = {
    "project_id": "23806000097545166",
    "from_date": "2025-05-01T00:00:00.000Z",
    "to_date": "2025-05-31T23:59:59.999Z",
    "time_period": "days",
    "group_by": "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}",
    "filter": "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}",
    "search_term": "Zoho Projects",
    "view_id": "23806000074760021",
    "next_token": "projects-99de5bbbfd5a29869a95cc2a0c02730fe77b9cf67ad2b7f5800445cc01583e26a8580a97622e7ff88dda837ef21ad24fb97e6eb8f06f1f41feb9761a201d3b9ba4939b375b5935c2cddd7d8b54654b32cce38d47db390c7cafba052fadb82f1d60d558b829611462a000a25c9cdf1e2d4f8eadd6eef30e3b7c802c807fc2c59672c30a75650e3621d53708e3d4ec738805a576354d47dd305db1756ca576a8da131c8d8042bf7eaf8d5464ac275f1a8ba9a70474deaa7f8809578e7bcc82706a11cef928393829993cdb62c0a89fa637"
}

headers = {
    "Authorization": "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa",
}

response = requests.get(url, headers=headers, params=params)

print(response.json())

#include <stdio.h>
#include <string.h>
#include <curl/curl.h>

int main(void) {
    CURL *curl = curl_easy_init();
    if (curl) {
        char *enc_project_id = curl_easy_escape(curl, "23806000097545166", 0);
        char *enc_from_date = curl_easy_escape(curl, "2025-05-01T00:00:00.000Z", 0);
        char *enc_to_date = curl_easy_escape(curl, "2025-05-31T23:59:59.999Z", 0);
        char *enc_time_period = curl_easy_escape(curl, "days", 0);
        char *enc_group_by = curl_easy_escape(curl, "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}", 0);
        char *enc_filter = curl_easy_escape(curl, "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}", 0);
        char *enc_search_term = curl_easy_escape(curl, "Zoho Projects", 0);
        char *enc_view_id = curl_easy_escape(curl, "23806000074760021", 0);
        char *enc_next_token = curl_easy_escape(curl, "projects-99de5bbbfd5a29869a95cc2a0c02730fe77b9cf67ad2b7f5800445cc01583e26a8580a97622e7ff88dda837ef21ad24fb97e6eb8f06f1f41feb9761a201d3b9ba4939b375b5935c2cddd7d8b54654b32cce38d47db390c7cafba052fadb82f1d60d558b829611462a000a25c9cdf1e2d4f8eadd6eef30e3b7c802c807fc2c59672c30a75650e3621d53708e3d4ec738805a576354d47dd305db1756ca576a8da131c8d8042bf7eaf8d5464ac275f1a8ba9a70474deaa7f8809578e7bcc82706a11cef928393829993cdb62c0a89fa637", 0);
        char url[2048];
        snprintf(url, sizeof(url), "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/[GROUP_ID]/owners?project_id=%s&from_date=%s&to_date=%s&time_period=%s&group_by=%s&filter=%s&search_term=%s&view_id=%s&next_token=%s", enc_project_id, enc_from_date, enc_to_date, enc_time_period, enc_group_by, enc_filter, enc_search_term, enc_view_id, enc_next_token);

        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

        curl_easy_setopt(curl, CURLOPT_URL, url);
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");

        CURLcode res = curl_easy_perform(curl);
        if (res != CURLE_OK)
            fprintf(stderr, "curl failed: %s\n", curl_easy_strerror(res));

        curl_free(enc_project_id);
        curl_free(enc_from_date);
        curl_free(enc_to_date);
        curl_free(enc_time_period);
        curl_free(enc_group_by);
        curl_free(enc_filter);
        curl_free(enc_search_term);
        curl_free(enc_view_id);
        curl_free(enc_next_token);
        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

using System.Net.Http;
using System.Text;
using System.Web;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

var query = HttpUtility.ParseQueryString(string.Empty);
query["project_id"] = "23806000097545166";
query["from_date"] = "2025-05-01T00:00:00.000Z";
query["to_date"] = "2025-05-31T23:59:59.999Z";
query["time_period"] = "days";
query["group_by"] = "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}";
query["filter"] = "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}";
query["search_term"] = "Zoho Projects";
query["view_id"] = "23806000074760021";
query["next_token"] = "projects-99de5bbbfd5a29869a95cc2a0c02730fe77b9cf67ad2b7f5800445cc01583e26a8580a97622e7ff88dda837ef21ad24fb97e6eb8f06f1f41feb9761a201d3b9ba4939b375b5935c2cddd7d8b54654b32cce38d47db390c7cafba052fadb82f1d60d558b829611462a000a25c9cdf1e2d4f8eadd6eef30e3b7c802c807fc2c59672c30a75650e3621d53708e3d4ec738805a576354d47dd305db1756ca576a8da131c8d8042bf7eaf8d5464ac275f1a8ba9a70474deaa7f8809578e7bcc82706a11cef928393829993cdb62c0a89fa637";
var uriBuilder = new UriBuilder("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/[GROUP_ID]/owners") { Query = query.ToString() };
var request = new HttpRequestMessage(HttpMethod.Get, uriBuilder.Uri);

var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

#include <iostream>
#include <string>
#include <curl/curl.h>

static size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* output) {
    output->append((char*)contents, size * nmemb);
    return size * nmemb;
}

int main() {
    CURL* curl = curl_easy_init();
    if (curl) {
        std::string response;
        char* enc_project_id = curl_easy_escape(curl, "23806000097545166", 0);
        char* enc_from_date = curl_easy_escape(curl, "2025-05-01T00:00:00.000Z", 0);
        char* enc_to_date = curl_easy_escape(curl, "2025-05-31T23:59:59.999Z", 0);
        char* enc_time_period = curl_easy_escape(curl, "days", 0);
        char* enc_group_by = curl_easy_escape(curl, "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}", 0);
        char* enc_filter = curl_easy_escape(curl, "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}", 0);
        char* enc_search_term = curl_easy_escape(curl, "Zoho Projects", 0);
        char* enc_view_id = curl_easy_escape(curl, "23806000074760021", 0);
        char* enc_next_token = curl_easy_escape(curl, "projects-99de5bbbfd5a29869a95cc2a0c02730fe77b9cf67ad2b7f5800445cc01583e26a8580a97622e7ff88dda837ef21ad24fb97e6eb8f06f1f41feb9761a201d3b9ba4939b375b5935c2cddd7d8b54654b32cce38d47db390c7cafba052fadb82f1d60d558b829611462a000a25c9cdf1e2d4f8eadd6eef30e3b7c802c807fc2c59672c30a75650e3621d53708e3d4ec738805a576354d47dd305db1756ca576a8da131c8d8042bf7eaf8d5464ac275f1a8ba9a70474deaa7f8809578e7bcc82706a11cef928393829993cdb62c0a89fa637", 0);
        std::string url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/[GROUP_ID]/owners";
        url += "?project_id=" + std::string(enc_project_id);
        url += "&from_date=" + std::string(enc_from_date);
        url += "&to_date=" + std::string(enc_to_date);
        url += "&time_period=" + std::string(enc_time_period);
        url += "&group_by=" + std::string(enc_group_by);
        url += "&filter=" + std::string(enc_filter);
        url += "&search_term=" + std::string(enc_search_term);
        url += "&view_id=" + std::string(enc_view_id);
        url += "&next_token=" + std::string(enc_next_token);

        struct curl_slist* headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

        curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);

        CURLcode res = curl_easy_perform(curl);
        if (res == CURLE_OK)
            std::cout << response << std::endl;
        else
            std::cerr << curl_easy_strerror(res) << std::endl;

        curl_free(enc_project_id);
        curl_free(enc_from_date);
        curl_free(enc_to_date);
        curl_free(enc_time_period);
        curl_free(enc_group_by);
        curl_free(enc_filter);
        curl_free(enc_search_term);
        curl_free(enc_view_id);
        curl_free(enc_next_token);
        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

(require '[clj-http.client :as client])

(let [enc-project_id (java.net.URLEncoder/encode "23806000097545166" "UTF-8")
      enc-from_date (java.net.URLEncoder/encode "2025-05-01T00:00:00.000Z" "UTF-8")
      enc-to_date (java.net.URLEncoder/encode "2025-05-31T23:59:59.999Z" "UTF-8")
      enc-time_period (java.net.URLEncoder/encode "days" "UTF-8")
      enc-group_by (java.net.URLEncoder/encode "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}" "UTF-8")
      enc-filter (java.net.URLEncoder/encode "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}" "UTF-8")
      enc-search_term (java.net.URLEncoder/encode "Zoho Projects" "UTF-8")
      enc-view_id (java.net.URLEncoder/encode "23806000074760021" "UTF-8")
      enc-next_token (java.net.URLEncoder/encode "projects-99de5bbbfd5a29869a95cc2a0c02730fe77b9cf67ad2b7f5800445cc01583e26a8580a97622e7ff88dda837ef21ad24fb97e6eb8f06f1f41feb9761a201d3b9ba4939b375b5935c2cddd7d8b54654b32cce38d47db390c7cafba052fadb82f1d60d558b829611462a000a25c9cdf1e2d4f8eadd6eef30e3b7c802c807fc2c59672c30a75650e3621d53708e3d4ec738805a576354d47dd305db1756ca576a8da131c8d8042bf7eaf8d5464ac275f1a8ba9a70474deaa7f8809578e7bcc82706a11cef928393829993cdb62c0a89fa637" "UTF-8")
      url (str "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/[GROUP_ID]/owners" "?project_id=" enc-project_id "&from_date=" enc-from_date "&to_date=" enc-to_date "&time_period=" enc-time_period "&group_by=" enc-group_by "&filter=" enc-filter "&search_term=" enc-search_term "&view_id=" enc-view_id "&next_token=" enc-next_token)]
(def response
  (client/get url
    {:headers {"Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"}
     :as :json}))

(println (:body response))

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
)

func main() {
    req, _ := http.NewRequest("GET", "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/[GROUP_ID]/owners", nil)
    q := req.URL.Query()
    q.Add("project_id", "23806000097545166")
    q.Add("from_date", "2025-05-01T00:00:00.000Z")
    q.Add("to_date", "2025-05-31T23:59:59.999Z")
    q.Add("time_period", "days")
    q.Add("group_by", "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}")
    q.Add("filter", "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}")
    q.Add("search_term", "Zoho Projects")
    q.Add("view_id", "23806000074760021")
    q.Add("next_token", "projects-99de5bbbfd5a29869a95cc2a0c02730fe77b9cf67ad2b7f5800445cc01583e26a8580a97622e7ff88dda837ef21ad24fb97e6eb8f06f1f41feb9761a201d3b9ba4939b375b5935c2cddd7d8b54654b32cce38d47db390c7cafba052fadb82f1d60d558b829611462a000a25c9cdf1e2d4f8eadd6eef30e3b7c802c807fc2c59672c30a75650e3621d53708e3d4ec738805a576354d47dd305db1756ca576a8da131c8d8042bf7eaf8d5464ac275f1a8ba9a70474deaa7f8809578e7bcc82706a11cef928393829993cdb62c0a89fa637")
    req.URL.RawQuery = q.Encode()
    req.Header.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

GET https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/[GROUP_ID]/owners?project_id=23806000097545166&from_date=2025-05-01T00%3A00%3A00.000Z&to_date=2025-05-31T23%3A59%3A59.999Z&time_period=days&group_by=%7B%22field_name%22%3A%22project_id%22%2C%22module%22%3A%22-%22%2C%22sort_by%22%3A%22-%22%7D&filter=%7B%22criteria%22%3A%5B%7B%22field_name%22%3A%22project_id%22%2C%22criteria_condition%22%3A%22is%22%2C%22value%22%3A%5B%2223806000097545166%22%5D%7D%5D%2C%22pattern%22%3A%221%22%7D&search_term=Zoho+Projects&view_id=23806000074760021&next_token=projects-99de5bbbfd5a29869a95cc2a0c02730fe77b9cf67ad2b7f5800445cc01583e26a8580a97622e7ff88dda837ef21ad24fb97e6eb8f06f1f41feb9761a201d3b9ba4939b375b5935c2cddd7d8b54654b32cce38d47db390c7cafba052fadb82f1d60d558b829611462a000a25c9cdf1e2d4f8eadd6eef30e3b7c802c807fc2c59672c30a75650e3621d53708e3d4ec738805a576354d47dd305db1756ca576a8da131c8d8042bf7eaf8d5464ac275f1a8ba9a70474deaa7f8809578e7bcc82706a11cef928393829993cdb62c0a89fa637 HTTP/1.1
Host: https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/[GROUP_ID]/owners?project_id=23806000097545166&from_date=2025-05-01T00%3A00%3A00.000Z&to_date=2025-05-31T23%3A59%3A59.999Z&time_period=days&group_by=%7B%22field_name%22%3A%22project_id%22%2C%22module%22%3A%22-%22%2C%22sort_by%22%3A%22-%22%7D&filter=%7B%22criteria%22%3A%5B%7B%22field_name%22%3A%22project_id%22%2C%22criteria_condition%22%3A%22is%22%2C%22value%22%3A%5B%2223806000097545166%22%5D%7D%5D%2C%22pattern%22%3A%221%22%7D&search_term=Zoho+Projects&view_id=23806000074760021&next_token=projects-99de5bbbfd5a29869a95cc2a0c02730fe77b9cf67ad2b7f5800445cc01583e26a8580a97622e7ff88dda837ef21ad24fb97e6eb8f06f1f41feb9761a201d3b9ba4939b375b5935c2cddd7d8b54654b32cce38d47db390c7cafba052fadb82f1d60d558b829611462a000a25c9cdf1e2d4f8eadd6eef30e3b7c802c807fc2c59672c30a75650e3621d53708e3d4ec738805a576354d47dd305db1756ca576a8da131c8d8042bf7eaf8d5464ac275f1a8ba9a70474deaa7f8809578e7bcc82706a11cef928393829993cdb62c0a89fa637
Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa

HttpClientBuilder httpClientBuilder = HttpClientBuilder.create();

SSLContext sslContext = SSLContext.getDefault();
SSLConnectionSocketFactory sslConnectionSocketFactory = new SSLConnectionSocketFactory(sslContext, NoopHostnameVerifier.INSTANCE);
CloseableHttpClient httpclient = httpClientBuilder.setSSLSocketFactory(sslConnectionSocketFactory).build();

URIBuilder uriBuilder = new URIBuilder("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/[GROUP_ID]/owners");
uriBuilder.addParameter("project_id", "23806000097545166");
uriBuilder.addParameter("from_date", "2025-05-01T00:00:00.000Z");
uriBuilder.addParameter("to_date", "2025-05-31T23:59:59.999Z");
uriBuilder.addParameter("time_period", "days");
uriBuilder.addParameter("group_by", "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}");
uriBuilder.addParameter("filter", "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}");
uriBuilder.addParameter("search_term", "Zoho Projects");
uriBuilder.addParameter("view_id", "23806000074760021");
uriBuilder.addParameter("next_token", "projects-99de5bbbfd5a29869a95cc2a0c02730fe77b9cf67ad2b7f5800445cc01583e26a8580a97622e7ff88dda837ef21ad24fb97e6eb8f06f1f41feb9761a201d3b9ba4939b375b5935c2cddd7d8b54654b32cce38d47db390c7cafba052fadb82f1d60d558b829611462a000a25c9cdf1e2d4f8eadd6eef30e3b7c802c807fc2c59672c30a75650e3621d53708e3d4ec738805a576354d47dd305db1756ca576a8da131c8d8042bf7eaf8d5464ac275f1a8ba9a70474deaa7f8809578e7bcc82706a11cef928393829993cdb62c0a89fa637");
HttpUriRequest requestObj = new HttpGet(uriBuilder.build());
requestObj.addHeader("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

HttpResponse response = httpclient.execute(requestObj);

HttpEntity responseEntity = response.getEntity();
Object responseObject = EntityUtils.toString(responseEntity);
String responseString = responseObject.toString();

const url = 'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/[GROUP_ID]/owners';

const params = new URLSearchParams({
  'project_id': '23806000097545166',
  'from_date': '2025-05-01T00:00:00.000Z',
  'to_date': '2025-05-31T23:59:59.999Z',
  'time_period': 'days',
  'group_by': '{"field_name":"project_id","module":"-","sort_by":"-"}',
  'filter': '{"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"}',
  'search_term': 'Zoho Projects',
  'view_id': '23806000074760021',
  'next_token': 'projects-99de5bbbfd5a29869a95cc2a0c02730fe77b9cf67ad2b7f5800445cc01583e26a8580a97622e7ff88dda837ef21ad24fb97e6eb8f06f1f41feb9761a201d3b9ba4939b375b5935c2cddd7d8b54654b32cce38d47db390c7cafba052fadb82f1d60d558b829611462a000a25c9cdf1e2d4f8eadd6eef30e3b7c802c807fc2c59672c30a75650e3621d53708e3d4ec738805a576354d47dd305db1756ca576a8da131c8d8042bf7eaf8d5464ac275f1a8ba9a70474deaa7f8809578e7bcc82706a11cef928393829993cdb62c0a89fa637'
});

const options = {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'
  }
};

fetch(url + '?' + params.toString(), options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error(error));

project_id = "23806000097545166"
from_date = "2025-05-01T00:00:00.000Z"
to_date = "2025-05-31T23:59:59.999Z"
time_period = "days"
group_by = {"field_name":"project_id","module":"-","sort_by":"-"}
filter = {"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"}
search_term = "Zoho Projects"
view_id = "23806000074760021"
next_token = "projects-99de5bbbfd5a29869a95cc2a0c02730fe77b9cf67ad2b7f5800445cc01583e26a8580a97622e7ff88dda837ef21ad24fb97e6eb8f06f1f41feb9761a201d3b9ba4939b375b5935c2cddd7d8b54654b32cce38d47db390c7cafba052fadb82f1d60d558b829611462a000a25c9cdf1e2d4f8eadd6eef30e3b7c802c807fc2c59672c30a75650e3621d53708e3d4ec738805a576354d47dd305db1756ca576a8da131c8d8042bf7eaf8d5464ac275f1a8ba9a70474deaa7f8809578e7bcc82706a11cef928393829993cdb62c0a89fa637"

import java.net.HttpURLConnection
import java.net.URL
import okhttp3.HttpUrl.Companion.toHttpUrl

fun main() {
    val urlBuilder = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/[GROUP_ID]/owners".toHttpUrl().newBuilder()
    urlBuilder.addQueryParameter("project_id", "23806000097545166")
    urlBuilder.addQueryParameter("from_date", "2025-05-01T00:00:00.000Z")
    urlBuilder.addQueryParameter("to_date", "2025-05-31T23:59:59.999Z")
    urlBuilder.addQueryParameter("time_period", "days")
    urlBuilder.addQueryParameter("group_by", "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}")
    urlBuilder.addQueryParameter("filter", "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}")
    urlBuilder.addQueryParameter("search_term", "Zoho Projects")
    urlBuilder.addQueryParameter("view_id", "23806000074760021")
    urlBuilder.addQueryParameter("next_token", "projects-99de5bbbfd5a29869a95cc2a0c02730fe77b9cf67ad2b7f5800445cc01583e26a8580a97622e7ff88dda837ef21ad24fb97e6eb8f06f1f41feb9761a201d3b9ba4939b375b5935c2cddd7d8b54654b32cce38d47db390c7cafba052fadb82f1d60d558b829611462a000a25c9cdf1e2d4f8eadd6eef30e3b7c802c807fc2c59672c30a75650e3621d53708e3d4ec738805a576354d47dd305db1756ca576a8da131c8d8042bf7eaf8d5464ac275f1a8ba9a70474deaa7f8809578e7bcc82706a11cef928393829993cdb62c0a89fa637")
    val url = URL(urlBuilder.build().toString())
    val conn = url.openConnection() as HttpURLConnection
    conn.requestMethod = "GET"
    conn.setRequestProperty("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")

    val response = conn.inputStream.bufferedReader().readText()
    println(response)
}

NSString *encodedProject_id = [@"23806000097545166" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedFrom_date = [@"2025-05-01T00:00:00.000Z" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedTo_date = [@"2025-05-31T23:59:59.999Z" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedTime_period = [@"days" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedGroup_by = [@"{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedFilter = [@"{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedSearch_term = [@"Zoho Projects" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedView_id = [@"23806000074760021" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedNext_token = [@"projects-99de5bbbfd5a29869a95cc2a0c02730fe77b9cf67ad2b7f5800445cc01583e26a8580a97622e7ff88dda837ef21ad24fb97e6eb8f06f1f41feb9761a201d3b9ba4939b375b5935c2cddd7d8b54654b32cce38d47db390c7cafba052fadb82f1d60d558b829611462a000a25c9cdf1e2d4f8eadd6eef30e3b7c802c807fc2c59672c30a75650e3621d53708e3d4ec738805a576354d47dd305db1756ca576a8da131c8d8042bf7eaf8d5464ac275f1a8ba9a70474deaa7f8809578e7bcc82706a11cef928393829993cdb62c0a89fa637" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *urlString = [NSString stringWithFormat:@"https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/[GROUP_ID]/owners?project_id=%@&from_date=%@&to_date=%@&time_period=%@&group_by=%@&filter=%@&search_term=%@&view_id=%@&next_token=%@", encodedProject_id, encodedFrom_date, encodedTo_date, encodedTime_period, encodedGroup_by, encodedFilter, encodedSearch_term, encodedView_id, encodedNext_token];
NSURL *url = [NSURL URLWithString:urlString];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
[request setHTTPMethod:@"GET"];
[request setValue:@"Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa" forHTTPHeaderField:@"Authorization"];

NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *task = [session dataTaskWithRequest:request
    completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
        NSString *result = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
        NSLog(@"%@", result);
}];
[task resume];

open Lwt
open Cohttp_lwt_unix

let () =
  let enc_project_id = Uri.pct_encode "23806000097545166" in
  let enc_from_date = Uri.pct_encode "2025-05-01T00:00:00.000Z" in
  let enc_to_date = Uri.pct_encode "2025-05-31T23:59:59.999Z" in
  let enc_time_period = Uri.pct_encode "days" in
  let enc_group_by = Uri.pct_encode "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}" in
  let enc_filter = Uri.pct_encode "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}" in
  let enc_search_term = Uri.pct_encode "Zoho Projects" in
  let enc_view_id = Uri.pct_encode "23806000074760021" in
  let enc_next_token = Uri.pct_encode "projects-99de5bbbfd5a29869a95cc2a0c02730fe77b9cf67ad2b7f5800445cc01583e26a8580a97622e7ff88dda837ef21ad24fb97e6eb8f06f1f41feb9761a201d3b9ba4939b375b5935c2cddd7d8b54654b32cce38d47db390c7cafba052fadb82f1d60d558b829611462a000a25c9cdf1e2d4f8eadd6eef30e3b7c802c807fc2c59672c30a75650e3621d53708e3d4ec738805a576354d47dd305db1756ca576a8da131c8d8042bf7eaf8d5464ac275f1a8ba9a70474deaa7f8809578e7bcc82706a11cef928393829993cdb62c0a89fa637" in
  let uri = Uri.of_string ("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/[GROUP_ID]/owners" ^ "?project_id=" ^ enc_project_id ^ "&from_date=" ^ enc_from_date ^ "&to_date=" ^ enc_to_date ^ "&time_period=" ^ enc_time_period ^ "&group_by=" ^ enc_group_by ^ "&filter=" ^ enc_filter ^ "&search_term=" ^ enc_search_term ^ "&view_id=" ^ enc_view_id ^ "&next_token=" ^ enc_next_token) in
  let headers = Cohttp.Header.init ()
    |> fun h -> Cohttp.Header.add h "Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
  in
  Lwt_main.run (
    Client.get ~headers uri >>= fun (_, body) ->
    Cohttp_lwt.Body.to_string body >|= fun s ->
    print_endline s)

$headers = @{
    "Authorization" = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
}

$params = @{
    project_id = "23806000097545166"
    from_date = "2025-05-01T00:00:00.000Z"
    to_date = "2025-05-31T23:59:59.999Z"
    time_period = "days"
    group_by = "{`"field_name`":`"project_id`",`"module`":`"-`",`"sort_by`":`"-`"}"
    filter = "{`"criteria`":[{`"field_name`":`"project_id`",`"criteria_condition`":`"is`",`"value`":[`"23806000097545166`"]}],`"pattern`":`"1`"}"
    search_term = "Zoho Projects"
    view_id = "23806000074760021"
    next_token = "projects-99de5bbbfd5a29869a95cc2a0c02730fe77b9cf67ad2b7f5800445cc01583e26a8580a97622e7ff88dda837ef21ad24fb97e6eb8f06f1f41feb9761a201d3b9ba4939b375b5935c2cddd7d8b54654b32cce38d47db390c7cafba052fadb82f1d60d558b829611462a000a25c9cdf1e2d4f8eadd6eef30e3b7c802c807fc2c59672c30a75650e3621d53708e3d4ec738805a576354d47dd305db1756ca576a8da131c8d8042bf7eaf8d5464ac275f1a8ba9a70474deaa7f8809578e7bcc82706a11cef928393829993cdb62c0a89fa637"
}
$queryString = ($params.GetEnumerator() | ForEach-Object { "$($_.Key)=$([System.Uri]::EscapeDataString($_.Value))" }) -join "&"
$url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/[GROUP_ID]/owners" + "?" + $queryString

$response = Invoke-RestMethod -Uri $url -Method GET -Headers $headers

$response | ConvertTo-Json

library(httr)

url <- "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/[GROUP_ID]/owners"

params <- list(
  project_id = "23806000097545166",
  from_date = "2025-05-01T00:00:00.000Z",
  to_date = "2025-05-31T23:59:59.999Z",
  time_period = "days",
  group_by = "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}",
  filter = "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}",
  search_term = "Zoho Projects",
  view_id = "23806000074760021",
  next_token = "projects-99de5bbbfd5a29869a95cc2a0c02730fe77b9cf67ad2b7f5800445cc01583e26a8580a97622e7ff88dda837ef21ad24fb97e6eb8f06f1f41feb9761a201d3b9ba4939b375b5935c2cddd7d8b54654b32cce38d47db390c7cafba052fadb82f1d60d558b829611462a000a25c9cdf1e2d4f8eadd6eef30e3b7c802c807fc2c59672c30a75650e3621d53708e3d4ec738805a576354d47dd305db1756ca576a8da131c8d8042bf7eaf8d5464ac275f1a8ba9a70474deaa7f8809578e7bcc82706a11cef928393829993cdb62c0a89fa637"
)

response <- GET(
  url,
  add_headers(Authorization = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"),
  query = params
)

content(response, "text")

import Foundation

var components = URLComponents(string: "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/[GROUP_ID]/owners")!
components.queryItems = [
    URLQueryItem(name: "project_id", value: "23806000097545166"),
    URLQueryItem(name: "from_date", value: "2025-05-01T00:00:00.000Z"),
    URLQueryItem(name: "to_date", value: "2025-05-31T23:59:59.999Z"),
    URLQueryItem(name: "time_period", value: "days"),
    URLQueryItem(name: "group_by", value: "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}"),
    URLQueryItem(name: "filter", value: "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}"),
    URLQueryItem(name: "search_term", value: "Zoho Projects"),
    URLQueryItem(name: "view_id", value: "23806000074760021"),
    URLQueryItem(name: "next_token", value: "projects-99de5bbbfd5a29869a95cc2a0c02730fe77b9cf67ad2b7f5800445cc01583e26a8580a97622e7ff88dda837ef21ad24fb97e6eb8f06f1f41feb9761a201d3b9ba4939b375b5935c2cddd7d8b54654b32cce38d47db390c7cafba052fadb82f1d60d558b829611462a000a25c9cdf1e2d4f8eadd6eef30e3b7c802c807fc2c59672c30a75650e3621d53708e3d4ec738805a576354d47dd305db1756ca576a8da131c8d8042bf7eaf8d5464ac275f1a8ba9a70474deaa7f8809578e7bcc82706a11cef928393829993cdb62c0a89fa637")
]
let url = components.url!
var request = URLRequest(url: url)
request.httpMethod = "GET"
request.setValue("Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa", forHTTPHeaderField: "Authorization")

let semaphore = DispatchSemaphore(value: 0)
let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data, let result = String(data: data, encoding: .utf8) {
        print(result)
    }
    semaphore.signal()
}
task.resume()
semaphore.wait()

Sample Input

project_id : "23806000097545166" from_date : "2025-05-01T00:00:00.000Z" to_date : "2025-05-31T23:59:59.999Z" time_period : "days" group_by : { "field_name" : "project_id", "module" : "-", "sort_by" : "-" } filter : { "criteria" : [ { "field_name" : "project_id", "criteria_condition" : "is", "value" : [ "23806000097545166" ] } ], "pattern" : "1" } search_term : "Zoho Projects" view_id : "23806000074760021" next_token : "projects-99de5bbbfd5a29869a95cc2a0c02730fe77b9cf67ad2b7f5800445cc01583e26a8580a97622e7ff88dda837ef21ad24fb97e6eb8f06f1f41feb9761a201d3b9ba4939b375b5935c2cddd7d8b54654b32cce38d47db390c7cafba052fadb82f1d60d558b829611462a000a25c9cdf1e2d4f8eadd6eef30e3b7c802c807fc2c59672c30a75650e3621d53708e3d4ec738805a576354d47dd305db1756ca576a8da131c8d8042bf7eaf8d5464ac275f1a8ba9a70474deaa7f8809578e7bcc82706a11cef928393829993cdb62c0a89fa637"

Sample Response

200{ "filter" : "{}", "business_hours" : { "default_id" : "4000000893039", "details" : [ { "holidays" : [ ], "working_day_availability" : { "2" : 540, "3" : 540, "4" : 540, "5" : 540, "6" : 540, "7" : 540 }, "name" : "Standard Business Hours", "id" : "4000000568047", "version" : 1 } ] }, "parents_with_owners" : [ { "parent_id" : "4000000002505", "owners" : [ { "secondary_id" : "22823316", "work" : { "overall_allocation" : "free", "total_availability" : 13500, "total_work" : 0, "total_date_work" : [ ], "project_date_work" : [ { "overall_allocation" : "free", "total_work" : 0, "id" : "4000000465005", "date_work" : [ ] } ] }, "business_hours_id" : "4000000893039", "name" : "Monica Hemsworth", "count" : { "users_count" : 1, "entity_count" : 0, "project_entity_count" : { "4000000465005" : 0 }, "recurring_entity_count" : 0 }, "id" : "4000000005079", "is_resource" : false } ] } ], "page_info" : { "index" : 1, "range" : 50, "has_next" : false } }

Get Records in Multiple Groups

Retrieve the list of records across multiple groups in the workload report. Use this API to fetch user, team, profile or role-level workload data across multiple groups, apply filters, and paginate through results.

GET

/api/v3/portal/[PORTAL_ID]/reports/workload/groups/owners

OAuth Scope:

ZohoProjects.portals.READ

Path Parameters

Param Name

Data Type

Description

portal_id

String

required
regex : [0-9]+

Unique, immutable identifier of the portal in Zoho Projects. You can obtain it from the Get Portals API (the "id" field in the response).

Query Parameters

Param Name

Data Type

Description

project_id

int

Enter the project ID (Not required for global reports).

from_date

String

Enter the start date of the chart.

to_date

String

Enter the end date of the chart.

time_period

String

regex : days|weeks|months

Enter the view period.
Accepted values : days,weeks,months

group_by

JSONObject

required

Specify the grouping criteria for the report data.

index

int

Enter the index of the record.

range

int

Enter the range of the record.

page

int

Enter the page number to retrieve.

per_page

int

Enter the number of entries to display per page.

filter

JSONObject

Enter the filter criteria to narrow down results.

group_ids

JSONArray

Specify the list of groups to retrieve owners for.

search_term

String

Enter the search term to look up specific records.

view_id

int

Enter the custom view ID.

Request Example

cURL
Deluge
Node.js
Ruby
PHP
- Python
- C
- C#
- C++
- Clojure
- Go
- HTTP
- Java
- JS Fetch
- JSON
- Kotlin
- Objective-C
- OCaml
- PowerShell
- R
- Swift

curl -X GET \
'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/owners?project_id=23806000097545166&from_date=2025-05-01T00%3A00%3A00.000Z&to_date=2025-05-31T23%3A59%3A59.999Z&time_period=days&group_by=%7B%22field_name%22%3A%22project_id%22%2C%22module%22%3A%22-%22%2C%22sort_by%22%3A%22-%22%7D&index=1&range=15&page=1&per_page=10&filter=%7B%22criteria%22%3A%5B%7B%22field_name%22%3A%22project_id%22%2C%22criteria_condition%22%3A%22is%22%2C%22value%22%3A%5B%2223806000097545166%22%5D%7D%5D%2C%22pattern%22%3A%221%22%7D&group_ids=%5B%7B%22id%22%3A%22-%22%2C%22count%22%3A%22-%22%7D%5D&search_term=Zoho+Projects&view_id=23806000074760021' \
-H 'Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/owners";
group_by_value = {"field_name":"project_id","module":"-","sort_by":"-"};
filter_value = {"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"};
group_ids_value = [{"id":"-","count":"-"}];
params = Map();
params.put("project_id", "23806000097545166");
params.put("from_date", "2025-05-01T00:00:00.000Z");
params.put("to_date", "2025-05-31T23:59:59.999Z");
params.put("time_period", "days");
params.put("group_by", group_by_value);
params.put("index", 1);
params.put("range", 15);
params.put("page", "1");
params.put("per_page", "10");
params.put("filter", filter_value);
params.put("group_ids", group_ids_value);
params.put("search_term", "Zoho Projects");
params.put("view_id", "23806000074760021");
response = invokeUrl
[
    url: url
    type: GET
    parameters: params
    connection: "projects"
];
info response;

const https = require('https');
const url = new URL('https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/owners');
url.searchParams.append('project_id', '23806000097545166');
url.searchParams.append('from_date', '2025-05-01T00:00:00.000Z');
url.searchParams.append('to_date', '2025-05-31T23:59:59.999Z');
url.searchParams.append('time_period', 'days');
url.searchParams.append('group_by', '{"field_name":"project_id","module":"-","sort_by":"-"}');
url.searchParams.append('index', '1');
url.searchParams.append('range', '15');
url.searchParams.append('page', '1');
url.searchParams.append('per_page', '10');
url.searchParams.append('filter', '{"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"}');
url.searchParams.append('group_ids', '[{"id":"-","count":"-"}]');
url.searchParams.append('search_term', 'Zoho Projects');
url.searchParams.append('view_id', '23806000074760021');

const options = {
  hostname: url.hostname,
  path: url.pathname + url.search,
  method: 'GET',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'
  }
};

const req = https.request(options, (res) => {
  let data = '';
  res.on('data', (chunk) => { data += chunk; });
  res.on('end', () => { console.log(JSON.parse(data)); });
});

req.on('error', (err) => { console.error(err); });
req.end();

require 'net/http'
require 'uri'
require 'json'

url = URI("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/owners")
params = {
  "project_id" => "23806000097545166",
  "from_date" => "2025-05-01T00:00:00.000Z",
  "to_date" => "2025-05-31T23:59:59.999Z",
  "time_period" => "days",
  "group_by" => "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}",
  "index" => "1",
  "range" => "15",
  "page" => "1",
  "per_page" => "10",
  "filter" => "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}",
  "group_ids" => "[{\"id\":\"-\",\"count\":\"-\"}]",
  "search_term" => "Zoho Projects",
  "view_id" => "23806000074760021"
}
url.query = URI.encode_www_form(params)

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"

response = http.request(request)
puts response.read_body

<?php
$params = [
    'project_id' => '23806000097545166',
    'from_date' => '2025-05-01T00:00:00.000Z',
    'to_date' => '2025-05-31T23:59:59.999Z',
    'time_period' => 'days',
    'group_by' => '{"field_name":"project_id","module":"-","sort_by":"-"}',
    'index' => '1',
    'range' => '15',
    'page' => '1',
    'per_page' => '10',
    'filter' => '{"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"}',
    'group_ids' => '[{"id":"-","count":"-"}]',
    'search_term' => 'Zoho Projects',
    'view_id' => '23806000074760021',
];
$url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/owners" . "?" . http_build_query($params);

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => $url,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

import requests

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/owners"

params = {
    "project_id": "23806000097545166",
    "from_date": "2025-05-01T00:00:00.000Z",
    "to_date": "2025-05-31T23:59:59.999Z",
    "time_period": "days",
    "group_by": "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}",
    "index": "1",
    "range": "15",
    "page": "1",
    "per_page": "10",
    "filter": "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}",
    "group_ids": "[{\"id\":\"-\",\"count\":\"-\"}]",
    "search_term": "Zoho Projects",
    "view_id": "23806000074760021"
}

headers = {
    "Authorization": "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa",
}

response = requests.get(url, headers=headers, params=params)

print(response.json())

#include <stdio.h>
#include <string.h>
#include <curl/curl.h>

int main(void) {
    CURL *curl = curl_easy_init();
    if (curl) {
        char *enc_project_id = curl_easy_escape(curl, "23806000097545166", 0);
        char *enc_from_date = curl_easy_escape(curl, "2025-05-01T00:00:00.000Z", 0);
        char *enc_to_date = curl_easy_escape(curl, "2025-05-31T23:59:59.999Z", 0);
        char *enc_time_period = curl_easy_escape(curl, "days", 0);
        char *enc_group_by = curl_easy_escape(curl, "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}", 0);
        char *enc_index = curl_easy_escape(curl, "1", 0);
        char *enc_range = curl_easy_escape(curl, "15", 0);
        char *enc_page = curl_easy_escape(curl, "1", 0);
        char *enc_per_page = curl_easy_escape(curl, "10", 0);
        char *enc_filter = curl_easy_escape(curl, "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}", 0);
        char *enc_group_ids = curl_easy_escape(curl, "[{\"id\":\"-\",\"count\":\"-\"}]", 0);
        char *enc_search_term = curl_easy_escape(curl, "Zoho Projects", 0);
        char *enc_view_id = curl_easy_escape(curl, "23806000074760021", 0);
        char url[2048];
        snprintf(url, sizeof(url), "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/owners?project_id=%s&from_date=%s&to_date=%s&time_period=%s&group_by=%s&index=%s&range=%s&page=%s&per_page=%s&filter=%s&group_ids=%s&search_term=%s&view_id=%s", enc_project_id, enc_from_date, enc_to_date, enc_time_period, enc_group_by, enc_index, enc_range, enc_page, enc_per_page, enc_filter, enc_group_ids, enc_search_term, enc_view_id);

        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

        curl_easy_setopt(curl, CURLOPT_URL, url);
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");

        CURLcode res = curl_easy_perform(curl);
        if (res != CURLE_OK)
            fprintf(stderr, "curl failed: %s\n", curl_easy_strerror(res));

        curl_free(enc_project_id);
        curl_free(enc_from_date);
        curl_free(enc_to_date);
        curl_free(enc_time_period);
        curl_free(enc_group_by);
        curl_free(enc_index);
        curl_free(enc_range);
        curl_free(enc_page);
        curl_free(enc_per_page);
        curl_free(enc_filter);
        curl_free(enc_group_ids);
        curl_free(enc_search_term);
        curl_free(enc_view_id);
        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

using System.Net.Http;
using System.Text;
using System.Web;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

var query = HttpUtility.ParseQueryString(string.Empty);
query["project_id"] = "23806000097545166";
query["from_date"] = "2025-05-01T00:00:00.000Z";
query["to_date"] = "2025-05-31T23:59:59.999Z";
query["time_period"] = "days";
query["group_by"] = "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}";
query["index"] = "1";
query["range"] = "15";
query["page"] = "1";
query["per_page"] = "10";
query["filter"] = "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}";
query["group_ids"] = "[{\"id\":\"-\",\"count\":\"-\"}]";
query["search_term"] = "Zoho Projects";
query["view_id"] = "23806000074760021";
var uriBuilder = new UriBuilder("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/owners") { Query = query.ToString() };
var request = new HttpRequestMessage(HttpMethod.Get, uriBuilder.Uri);

var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

#include <iostream>
#include <string>
#include <curl/curl.h>

static size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* output) {
    output->append((char*)contents, size * nmemb);
    return size * nmemb;
}

int main() {
    CURL* curl = curl_easy_init();
    if (curl) {
        std::string response;
        char* enc_project_id = curl_easy_escape(curl, "23806000097545166", 0);
        char* enc_from_date = curl_easy_escape(curl, "2025-05-01T00:00:00.000Z", 0);
        char* enc_to_date = curl_easy_escape(curl, "2025-05-31T23:59:59.999Z", 0);
        char* enc_time_period = curl_easy_escape(curl, "days", 0);
        char* enc_group_by = curl_easy_escape(curl, "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}", 0);
        char* enc_index = curl_easy_escape(curl, "1", 0);
        char* enc_range = curl_easy_escape(curl, "15", 0);
        char* enc_page = curl_easy_escape(curl, "1", 0);
        char* enc_per_page = curl_easy_escape(curl, "10", 0);
        char* enc_filter = curl_easy_escape(curl, "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}", 0);
        char* enc_group_ids = curl_easy_escape(curl, "[{\"id\":\"-\",\"count\":\"-\"}]", 0);
        char* enc_search_term = curl_easy_escape(curl, "Zoho Projects", 0);
        char* enc_view_id = curl_easy_escape(curl, "23806000074760021", 0);
        std::string url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/owners";
        url += "?project_id=" + std::string(enc_project_id);
        url += "&from_date=" + std::string(enc_from_date);
        url += "&to_date=" + std::string(enc_to_date);
        url += "&time_period=" + std::string(enc_time_period);
        url += "&group_by=" + std::string(enc_group_by);
        url += "&index=" + std::string(enc_index);
        url += "&range=" + std::string(enc_range);
        url += "&page=" + std::string(enc_page);
        url += "&per_page=" + std::string(enc_per_page);
        url += "&filter=" + std::string(enc_filter);
        url += "&group_ids=" + std::string(enc_group_ids);
        url += "&search_term=" + std::string(enc_search_term);
        url += "&view_id=" + std::string(enc_view_id);

        struct curl_slist* headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

        curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "GET");
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);

        CURLcode res = curl_easy_perform(curl);
        if (res == CURLE_OK)
            std::cout << response << std::endl;
        else
            std::cerr << curl_easy_strerror(res) << std::endl;

        curl_free(enc_project_id);
        curl_free(enc_from_date);
        curl_free(enc_to_date);
        curl_free(enc_time_period);
        curl_free(enc_group_by);
        curl_free(enc_index);
        curl_free(enc_range);
        curl_free(enc_page);
        curl_free(enc_per_page);
        curl_free(enc_filter);
        curl_free(enc_group_ids);
        curl_free(enc_search_term);
        curl_free(enc_view_id);
        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

(require '[clj-http.client :as client])

(let [enc-project_id (java.net.URLEncoder/encode "23806000097545166" "UTF-8")
      enc-from_date (java.net.URLEncoder/encode "2025-05-01T00:00:00.000Z" "UTF-8")
      enc-to_date (java.net.URLEncoder/encode "2025-05-31T23:59:59.999Z" "UTF-8")
      enc-time_period (java.net.URLEncoder/encode "days" "UTF-8")
      enc-group_by (java.net.URLEncoder/encode "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}" "UTF-8")
      enc-index (java.net.URLEncoder/encode "1" "UTF-8")
      enc-range (java.net.URLEncoder/encode "15" "UTF-8")
      enc-page (java.net.URLEncoder/encode "1" "UTF-8")
      enc-per_page (java.net.URLEncoder/encode "10" "UTF-8")
      enc-filter (java.net.URLEncoder/encode "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}" "UTF-8")
      enc-group_ids (java.net.URLEncoder/encode "[{\"id\":\"-\",\"count\":\"-\"}]" "UTF-8")
      enc-search_term (java.net.URLEncoder/encode "Zoho Projects" "UTF-8")
      enc-view_id (java.net.URLEncoder/encode "23806000074760021" "UTF-8")
      url (str "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/owners" "?project_id=" enc-project_id "&from_date=" enc-from_date "&to_date=" enc-to_date "&time_period=" enc-time_period "&group_by=" enc-group_by "&index=" enc-index "&range=" enc-range "&page=" enc-page "&per_page=" enc-per_page "&filter=" enc-filter "&group_ids=" enc-group_ids "&search_term=" enc-search_term "&view_id=" enc-view_id)]
(def response
  (client/get url
    {:headers {"Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"}
     :as :json}))

(println (:body response))

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
)

func main() {
    req, _ := http.NewRequest("GET", "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/owners", nil)
    q := req.URL.Query()
    q.Add("project_id", "23806000097545166")
    q.Add("from_date", "2025-05-01T00:00:00.000Z")
    q.Add("to_date", "2025-05-31T23:59:59.999Z")
    q.Add("time_period", "days")
    q.Add("group_by", "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}")
    q.Add("index", "1")
    q.Add("range", "15")
    q.Add("page", "1")
    q.Add("per_page", "10")
    q.Add("filter", "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}")
    q.Add("group_ids", "[{\"id\":\"-\",\"count\":\"-\"}]")
    q.Add("search_term", "Zoho Projects")
    q.Add("view_id", "23806000074760021")
    req.URL.RawQuery = q.Encode()
    req.Header.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

GET https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/owners?project_id=23806000097545166&from_date=2025-05-01T00%3A00%3A00.000Z&to_date=2025-05-31T23%3A59%3A59.999Z&time_period=days&group_by=%7B%22field_name%22%3A%22project_id%22%2C%22module%22%3A%22-%22%2C%22sort_by%22%3A%22-%22%7D&index=1&range=15&page=1&per_page=10&filter=%7B%22criteria%22%3A%5B%7B%22field_name%22%3A%22project_id%22%2C%22criteria_condition%22%3A%22is%22%2C%22value%22%3A%5B%2223806000097545166%22%5D%7D%5D%2C%22pattern%22%3A%221%22%7D&group_ids=%5B%7B%22id%22%3A%22-%22%2C%22count%22%3A%22-%22%7D%5D&search_term=Zoho+Projects&view_id=23806000074760021 HTTP/1.1
Host: https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/owners?project_id=23806000097545166&from_date=2025-05-01T00%3A00%3A00.000Z&to_date=2025-05-31T23%3A59%3A59.999Z&time_period=days&group_by=%7B%22field_name%22%3A%22project_id%22%2C%22module%22%3A%22-%22%2C%22sort_by%22%3A%22-%22%7D&index=1&range=15&page=1&per_page=10&filter=%7B%22criteria%22%3A%5B%7B%22field_name%22%3A%22project_id%22%2C%22criteria_condition%22%3A%22is%22%2C%22value%22%3A%5B%2223806000097545166%22%5D%7D%5D%2C%22pattern%22%3A%221%22%7D&group_ids=%5B%7B%22id%22%3A%22-%22%2C%22count%22%3A%22-%22%7D%5D&search_term=Zoho+Projects&view_id=23806000074760021
Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa

HttpClientBuilder httpClientBuilder = HttpClientBuilder.create();

SSLContext sslContext = SSLContext.getDefault();
SSLConnectionSocketFactory sslConnectionSocketFactory = new SSLConnectionSocketFactory(sslContext, NoopHostnameVerifier.INSTANCE);
CloseableHttpClient httpclient = httpClientBuilder.setSSLSocketFactory(sslConnectionSocketFactory).build();

URIBuilder uriBuilder = new URIBuilder("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/owners");
uriBuilder.addParameter("project_id", "23806000097545166");
uriBuilder.addParameter("from_date", "2025-05-01T00:00:00.000Z");
uriBuilder.addParameter("to_date", "2025-05-31T23:59:59.999Z");
uriBuilder.addParameter("time_period", "days");
uriBuilder.addParameter("group_by", "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}");
uriBuilder.addParameter("index", "1");
uriBuilder.addParameter("range", "15");
uriBuilder.addParameter("page", "1");
uriBuilder.addParameter("per_page", "10");
uriBuilder.addParameter("filter", "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}");
uriBuilder.addParameter("group_ids", "[{\"id\":\"-\",\"count\":\"-\"}]");
uriBuilder.addParameter("search_term", "Zoho Projects");
uriBuilder.addParameter("view_id", "23806000074760021");
HttpUriRequest requestObj = new HttpGet(uriBuilder.build());
requestObj.addHeader("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

HttpResponse response = httpclient.execute(requestObj);

HttpEntity responseEntity = response.getEntity();
Object responseObject = EntityUtils.toString(responseEntity);
String responseString = responseObject.toString();

const url = 'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/owners';

const params = new URLSearchParams({
  'project_id': '23806000097545166',
  'from_date': '2025-05-01T00:00:00.000Z',
  'to_date': '2025-05-31T23:59:59.999Z',
  'time_period': 'days',
  'group_by': '{"field_name":"project_id","module":"-","sort_by":"-"}',
  'index': '1',
  'range': '15',
  'page': '1',
  'per_page': '10',
  'filter': '{"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"}',
  'group_ids': '[{"id":"-","count":"-"}]',
  'search_term': 'Zoho Projects',
  'view_id': '23806000074760021'
});

const options = {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa'
  }
};

fetch(url + '?' + params.toString(), options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error(error));

project_id = "23806000097545166"
from_date = "2025-05-01T00:00:00.000Z"
to_date = "2025-05-31T23:59:59.999Z"
time_period = "days"
group_by = {"field_name":"project_id","module":"-","sort_by":"-"}
index = 1
range = 15
page = "1"
per_page = "10"
filter = {"criteria":[{"field_name":"project_id","criteria_condition":"is","value":["23806000097545166"]}],"pattern":"1"}
group_ids = [{"id":"-","count":"-"}]
search_term = "Zoho Projects"
view_id = "23806000074760021"

import java.net.HttpURLConnection
import java.net.URL
import okhttp3.HttpUrl.Companion.toHttpUrl

fun main() {
    val urlBuilder = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/owners".toHttpUrl().newBuilder()
    urlBuilder.addQueryParameter("project_id", "23806000097545166")
    urlBuilder.addQueryParameter("from_date", "2025-05-01T00:00:00.000Z")
    urlBuilder.addQueryParameter("to_date", "2025-05-31T23:59:59.999Z")
    urlBuilder.addQueryParameter("time_period", "days")
    urlBuilder.addQueryParameter("group_by", "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}")
    urlBuilder.addQueryParameter("index", "1")
    urlBuilder.addQueryParameter("range", "15")
    urlBuilder.addQueryParameter("page", "1")
    urlBuilder.addQueryParameter("per_page", "10")
    urlBuilder.addQueryParameter("filter", "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}")
    urlBuilder.addQueryParameter("group_ids", "[{\"id\":\"-\",\"count\":\"-\"}]")
    urlBuilder.addQueryParameter("search_term", "Zoho Projects")
    urlBuilder.addQueryParameter("view_id", "23806000074760021")
    val url = URL(urlBuilder.build().toString())
    val conn = url.openConnection() as HttpURLConnection
    conn.requestMethod = "GET"
    conn.setRequestProperty("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")

    val response = conn.inputStream.bufferedReader().readText()
    println(response)
}

NSString *encodedProject_id = [@"23806000097545166" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedFrom_date = [@"2025-05-01T00:00:00.000Z" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedTo_date = [@"2025-05-31T23:59:59.999Z" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedTime_period = [@"days" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedGroup_by = [@"{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedIndex = [@"1" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedRange = [@"15" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedPage = [@"1" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedPer_page = [@"10" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedFilter = [@"{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedGroup_ids = [@"[{\"id\":\"-\",\"count\":\"-\"}]" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedSearch_term = [@"Zoho Projects" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *encodedView_id = [@"23806000074760021" stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]];
NSString *urlString = [NSString stringWithFormat:@"https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/owners?project_id=%@&from_date=%@&to_date=%@&time_period=%@&group_by=%@&index=%@&range=%@&page=%@&per_page=%@&filter=%@&group_ids=%@&search_term=%@&view_id=%@", encodedProject_id, encodedFrom_date, encodedTo_date, encodedTime_period, encodedGroup_by, encodedIndex, encodedRange, encodedPage, encodedPer_page, encodedFilter, encodedGroup_ids, encodedSearch_term, encodedView_id];
NSURL *url = [NSURL URLWithString:urlString];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
[request setHTTPMethod:@"GET"];
[request setValue:@"Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa" forHTTPHeaderField:@"Authorization"];

NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *task = [session dataTaskWithRequest:request
    completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
        NSString *result = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
        NSLog(@"%@", result);
}];
[task resume];

open Lwt
open Cohttp_lwt_unix

let () =
  let enc_project_id = Uri.pct_encode "23806000097545166" in
  let enc_from_date = Uri.pct_encode "2025-05-01T00:00:00.000Z" in
  let enc_to_date = Uri.pct_encode "2025-05-31T23:59:59.999Z" in
  let enc_time_period = Uri.pct_encode "days" in
  let enc_group_by = Uri.pct_encode "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}" in
  let enc_index = Uri.pct_encode "1" in
  let enc_range = Uri.pct_encode "15" in
  let enc_page = Uri.pct_encode "1" in
  let enc_per_page = Uri.pct_encode "10" in
  let enc_filter = Uri.pct_encode "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}" in
  let enc_group_ids = Uri.pct_encode "[{\"id\":\"-\",\"count\":\"-\"}]" in
  let enc_search_term = Uri.pct_encode "Zoho Projects" in
  let enc_view_id = Uri.pct_encode "23806000074760021" in
  let uri = Uri.of_string ("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/owners" ^ "?project_id=" ^ enc_project_id ^ "&from_date=" ^ enc_from_date ^ "&to_date=" ^ enc_to_date ^ "&time_period=" ^ enc_time_period ^ "&group_by=" ^ enc_group_by ^ "&index=" ^ enc_index ^ "&range=" ^ enc_range ^ "&page=" ^ enc_page ^ "&per_page=" ^ enc_per_page ^ "&filter=" ^ enc_filter ^ "&group_ids=" ^ enc_group_ids ^ "&search_term=" ^ enc_search_term ^ "&view_id=" ^ enc_view_id) in
  let headers = Cohttp.Header.init ()
    |> fun h -> Cohttp.Header.add h "Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
  in
  Lwt_main.run (
    Client.get ~headers uri >>= fun (_, body) ->
    Cohttp_lwt.Body.to_string body >|= fun s ->
    print_endline s)

$headers = @{
    "Authorization" = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
}

$params = @{
    project_id = "23806000097545166"
    from_date = "2025-05-01T00:00:00.000Z"
    to_date = "2025-05-31T23:59:59.999Z"
    time_period = "days"
    group_by = "{`"field_name`":`"project_id`",`"module`":`"-`",`"sort_by`":`"-`"}"
    index = "1"
    range = "15"
    page = "1"
    per_page = "10"
    filter = "{`"criteria`":[{`"field_name`":`"project_id`",`"criteria_condition`":`"is`",`"value`":[`"23806000097545166`"]}],`"pattern`":`"1`"}"
    group_ids = "[{`"id`":`"-`",`"count`":`"-`"}]"
    search_term = "Zoho Projects"
    view_id = "23806000074760021"
}
$queryString = ($params.GetEnumerator() | ForEach-Object { "$($_.Key)=$([System.Uri]::EscapeDataString($_.Value))" }) -join "&"
$url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/owners" + "?" + $queryString

$response = Invoke-RestMethod -Uri $url -Method GET -Headers $headers

$response | ConvertTo-Json

library(httr)

url <- "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/owners"

params <- list(
  project_id = "23806000097545166",
  from_date = "2025-05-01T00:00:00.000Z",
  to_date = "2025-05-31T23:59:59.999Z",
  time_period = "days",
  group_by = "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}",
  index = "1",
  range = "15",
  page = "1",
  per_page = "10",
  filter = "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}",
  group_ids = "[{\"id\":\"-\",\"count\":\"-\"}]",
  search_term = "Zoho Projects",
  view_id = "23806000074760021"
)

response <- GET(
  url,
  add_headers(Authorization = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"),
  query = params
)

content(response, "text")

import Foundation

var components = URLComponents(string: "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/workload/groups/owners")!
components.queryItems = [
    URLQueryItem(name: "project_id", value: "23806000097545166"),
    URLQueryItem(name: "from_date", value: "2025-05-01T00:00:00.000Z"),
    URLQueryItem(name: "to_date", value: "2025-05-31T23:59:59.999Z"),
    URLQueryItem(name: "time_period", value: "days"),
    URLQueryItem(name: "group_by", value: "{\"field_name\":\"project_id\",\"module\":\"-\",\"sort_by\":\"-\"}"),
    URLQueryItem(name: "index", value: "1"),
    URLQueryItem(name: "range", value: "15"),
    URLQueryItem(name: "page", value: "1"),
    URLQueryItem(name: "per_page", value: "10"),
    URLQueryItem(name: "filter", value: "{\"criteria\":[{\"field_name\":\"project_id\",\"criteria_condition\":\"is\",\"value\":[\"23806000097545166\"]}],\"pattern\":\"1\"}"),
    URLQueryItem(name: "group_ids", value: "[{\"id\":\"-\",\"count\":\"-\"}]"),
    URLQueryItem(name: "search_term", value: "Zoho Projects"),
    URLQueryItem(name: "view_id", value: "23806000074760021")
]
let url = components.url!
var request = URLRequest(url: url)
request.httpMethod = "GET"
request.setValue("Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa", forHTTPHeaderField: "Authorization")

let semaphore = DispatchSemaphore(value: 0)
let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data, let result = String(data: data, encoding: .utf8) {
        print(result)
    }
    semaphore.signal()
}
task.resume()
semaphore.wait()

Sample Input

Sample Response

200{ "filter" : "{}", "business_hours" : { "default_id" : "4000000893039", "details" : [ { "holidays" : [ ], "working_day_availability" : { "2" : 540, "3" : 540, "4" : 540, "5" : 540, "6" : 540, "7" : 540 }, "name" : "Standard Business Hours", "id" : "4000000568047", "version" : 1 } ] }, "parents_with_owners" : [ { "parent_id" : "4000000002502", "owners" : [ { "secondary_id" : "18891770", "work" : { "overall_allocation" : "under", "total_availability" : 13500, "total_work" : 11340, "total_date_work" : [ { "date" : "20260626", "allocation" : "optimal", "work" : 540 } ], "project_date_work" : [ { "overall_allocation" : "under", "total_work" : 11340, "id" : "4000000465005", "date_work" : [ { "date" : "20260626", "allocation" : "optimal", "work" : 540 } ] } ] }, "business_hours_id" : "4000000893039", "name" : "Monica Hemsworth", "count" : { "users_count" : 1, "entity_count" : 0, "project_entity_count" : { "4000000465005" : 1 }, "recurring_entity_count" : 1 }, "id" : "4000000002143", "is_resource" : false } ] } ], "page_info" : { "index" : 1, "range" : 50, "has_next" : false } }

Create or Update Custom Workload Report

Create or Update a custom workload report in the Zoho projects portal.

PUT

/api/v3/portal/[PORTAL_ID]/reports/custom-workload

OAuth Scope:

ZohoProjects.portals.CREATE

Path Parameters

Param Name

Data Type

Description

portal_id

String

required
regex : [0-9]+

Unique, immutable identifier of the portal in Zoho Projects. You can obtain it from the Get Portals API (the "id" field in the response).

Body Parameters

Param Name

Data Type

Description

String

Enter the view ID (Required for update).

module

String

required
max length : 100

Enter the module name.

name

String

max length : 100

Enter the name of the custom workload report.

description

String

max length : 255

Enter the description of the report.

view_access_type

String

regex : only_to_me|public|shared|internal

Specify the access type for the report view.
Accepted values : only_to_me,public,shared,internal

project_access_type

String

regex : all_projects|specific_project|selected_projects

Specify the project access type.
Accepted values : all_projects,specific_project,selected_projects

is_globally_accessible

boolean

Specify whether this report is globally accessible.

determiner

JSONObject

max length : 10000

Specify the filter criteria configuration for the report.

project

JSONObject

Specify the project details to associate with the report.

shared_users

JSONArray

max length : 10000
array size : >=0

Specify the list of users to share the report with.

shared_projects

JSONArray

max length : 10000
array size : >=0

Specify the list of projects to share the report with.

group_by

JSONArray

max length : 1000
array size : 1-1

Specify the grouping details for the report.

view_period

JSONObject

max length : 1000

Specify the view period configuration for the report.

report_preference

JSONObject

max length : 500

Specify the display preferences for the report.

Request Example

cURL
Deluge
Node.js
Ruby
PHP
- Python
- C
- C#
- C++
- Clojure
- Go
- HTTP
- Java
- JS Fetch
- JSON
- Kotlin
- Objective-C
- OCaml
- PowerShell
- R
- Swift

curl -X PUT \
'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/custom-workload' \
-H 'Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa' \
-H 'Content-Type: application/json' \
-d '{"id":"4000000062001","module":"workload","name":"Custom Reports Sheduled Export","description":"My Saved Custom Workload Report","view_access_type":"public","project_access_type":"specific_project","is_globally_accessible":true,"determiner":{"pattern":"1 AND 2","criteria":[{"module":"workload","field_name":"profiles","condition":"contains","value":["1752587000000097269"]}]},"project":{"id":"4000000062001"},"shared_users":[{"zpuid":"4000000002055"}],"shared_projects":[{"id":"4000000062001"}],"group_by":[{"field_name":"users","module":"workload","sort_by":"asc"}],"view_period":{"time_period":"days","time_period_type":"relative","relative_time_period":"current_month","absolute_start_date":"2026-07-01","absolute_end_date":"2026-07-31"},"report_preference":{"legend":"allocatedhrs","view_type":"heatmap","bar_type":"gantt","show_option":{"project_title":"false","task_title":"false"},"report_based_on":"users"}}'

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/custom-workload";
params = Map();
params.put("id", "4000000062001");
params.put("module", "workload");
params.put("name", "Custom Reports Sheduled Export");
params.put("description", "My Saved Custom Workload Report");
params.put("view_access_type", "public");
params.put("project_access_type", "specific_project");
params.put("is_globally_accessible", true);
params.put("determiner", {"pattern":"1 AND 2","criteria":[{"module":"workload","field_name":"profiles","condition":"contains","value":["1752587000000097269"]}]});
params.put("project", {"id":"4000000062001"});
params.put("shared_users", [{"zpuid":"4000000002055"}]);
params.put("shared_projects", [{"id":"4000000062001"}]);
params.put("group_by", [{"field_name":"users","module":"workload","sort_by":"asc"}]);
params.put("view_period", {"time_period":"days","time_period_type":"relative","relative_time_period":"current_month","absolute_start_date":"2026-07-01","absolute_end_date":"2026-07-31"});
params.put("report_preference", {"legend":"allocatedhrs","view_type":"heatmap","bar_type":"gantt","show_option":{"project_title":"false","task_title":"false"},"report_based_on":"users"});
response = invokeUrl
[
    url: url
    type: PUT
    parameters: params.toString()
    connection: "projects"
];
info response;

const https = require('https');
const url = new URL('https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/custom-workload');

const payload = JSON.stringify({"id":"4000000062001","module":"workload","name":"Custom Reports Sheduled Export","description":"My Saved Custom Workload Report","view_access_type":"public","project_access_type":"specific_project","is_globally_accessible":true,"determiner":{"pattern":"1 AND 2","criteria":[{"module":"workload","field_name":"profiles","condition":"contains","value":["1752587000000097269"]}]},"project":{"id":"4000000062001"},"shared_users":[{"zpuid":"4000000002055"}],"shared_projects":[{"id":"4000000062001"}],"group_by":[{"field_name":"users","module":"workload","sort_by":"asc"}],"view_period":{"time_period":"days","time_period_type":"relative","relative_time_period":"current_month","absolute_start_date":"2026-07-01","absolute_end_date":"2026-07-31"},"report_preference":{"legend":"allocatedhrs","view_type":"heatmap","bar_type":"gantt","show_option":{"project_title":"false","task_title":"false"},"report_based_on":"users"}});

const options = {
  hostname: url.hostname,
  path: url.pathname + url.search,
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa',
    'Content-Type': 'application/json',
    'Content-Length': Buffer.byteLength(payload)
  }
};

const req = https.request(options, (res) => {
  let data = '';
  res.on('data', (chunk) => { data += chunk; });
  res.on('end', () => { console.log(JSON.parse(data)); });
});

req.on('error', (err) => { console.error(err); });
req.write(payload);
req.end();

require 'net/http'
require 'uri'
require 'json'

url = URI("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/custom-workload")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
request["Content-Type"] = "application/json"
request.body = '{"id":"4000000062001","module":"workload","name":"Custom Reports Sheduled Export","description":"My Saved Custom Workload Report","view_access_type":"public","project_access_type":"specific_project","is_globally_accessible":true,"determiner":{"pattern":"1 AND 2","criteria":[{"module":"workload","field_name":"profiles","condition":"contains","value":["1752587000000097269"]}]},"project":{"id":"4000000062001"},"shared_users":[{"zpuid":"4000000002055"}],"shared_projects":[{"id":"4000000062001"}],"group_by":[{"field_name":"users","module":"workload","sort_by":"asc"}],"view_period":{"time_period":"days","time_period_type":"relative","relative_time_period":"current_month","absolute_start_date":"2026-07-01","absolute_end_date":"2026-07-31"},"report_preference":{"legend":"allocatedhrs","view_type":"heatmap","bar_type":"gantt","show_option":{"project_title":"false","task_title":"false"},"report_based_on":"users"}}'

response = http.request(request)
puts response.read_body

<?php
$url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/custom-workload";

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => $url,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => '{"id":"4000000062001","module":"workload","name":"Custom Reports Sheduled Export","description":"My Saved Custom Workload Report","view_access_type":"public","project_access_type":"specific_project","is_globally_accessible":true,"determiner":{"pattern":"1 AND 2","criteria":[{"module":"workload","field_name":"profiles","condition":"contains","value":["1752587000000097269"]}]},"project":{"id":"4000000062001"},"shared_users":[{"zpuid":"4000000002055"}],"shared_projects":[{"id":"4000000062001"}],"group_by":[{"field_name":"users","module":"workload","sort_by":"asc"}],"view_period":{"time_period":"days","time_period_type":"relative","relative_time_period":"current_month","absolute_start_date":"2026-07-01","absolute_end_date":"2026-07-31"},"report_preference":{"legend":"allocatedhrs","view_type":"heatmap","bar_type":"gantt","show_option":{"project_title":"false","task_title":"false"},"report_based_on":"users"}}',
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

import requests

url = "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/custom-workload"

headers = {
    "Authorization": "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa",
    "Content-Type": "application/json",
}

payload = '{"id":"4000000062001","module":"workload","name":"Custom Reports Sheduled Export","description":"My Saved Custom Workload Report","view_access_type":"public","project_access_type":"specific_project","is_globally_accessible":true,"determiner":{"pattern":"1 AND 2","criteria":[{"module":"workload","field_name":"profiles","condition":"contains","value":["1752587000000097269"]}]},"project":{"id":"4000000062001"},"shared_users":[{"zpuid":"4000000002055"}],"shared_projects":[{"id":"4000000062001"}],"group_by":[{"field_name":"users","module":"workload","sort_by":"asc"}],"view_period":{"time_period":"days","time_period_type":"relative","relative_time_period":"current_month","absolute_start_date":"2026-07-01","absolute_end_date":"2026-07-31"},"report_preference":{"legend":"allocatedhrs","view_type":"heatmap","bar_type":"gantt","show_option":{"project_title":"false","task_title":"false"},"report_based_on":"users"}}'

response = requests.put(url, headers=headers, data=payload)

print(response.json())

#include <stdio.h>
#include <string.h>
#include <curl/curl.h>

int main(void) {
    CURL *curl = curl_easy_init();
    if (curl) {
        struct curl_slist *headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");
        headers = curl_slist_append(headers, "Content-Type: application/json");

        curl_easy_setopt(curl, CURLOPT_URL, "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/custom-workload");
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "PUT");
        curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "{\"id\":\"4000000062001\",\"module\":\"workload\",\"name\":\"Custom Reports Sheduled Export\",\"description\":\"My Saved Custom Workload Report\",\"view_access_type\":\"public\",\"project_access_type\":\"specific_project\",\"is_globally_accessible\":true,\"determiner\":{\"pattern\":\"1 AND 2\",\"criteria\":[{\"module\":\"workload\",\"field_name\":\"profiles\",\"condition\":\"contains\",\"value\":[\"1752587000000097269\"]}]},\"project\":{\"id\":\"4000000062001\"},\"shared_users\":[{\"zpuid\":\"4000000002055\"}],\"shared_projects\":[{\"id\":\"4000000062001\"}],\"group_by\":[{\"field_name\":\"users\",\"module\":\"workload\",\"sort_by\":\"asc\"}],\"view_period\":{\"time_period\":\"days\",\"time_period_type\":\"relative\",\"relative_time_period\":\"current_month\",\"absolute_start_date\":\"2026-07-01\",\"absolute_end_date\":\"2026-07-31\"},\"report_preference\":{\"legend\":\"allocatedhrs\",\"view_type\":\"heatmap\",\"bar_type\":\"gantt\",\"show_option\":{\"project_title\":\"false\",\"task_title\":\"false\"},\"report_based_on\":\"users\"}}");

        CURLcode res = curl_easy_perform(curl);
        if (res != CURLE_OK)
            fprintf(stderr, "curl failed: %s\n", curl_easy_strerror(res));

        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

using System.Net.Http;
using System.Text;
using System.Web;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

var request = new HttpRequestMessage(HttpMethod.Put, "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/custom-workload");
request.Content = new StringContent(
    @"{""id"":""4000000062001"",""module"":""workload"",""name"":""Custom Reports Sheduled Export"",""description"":""My Saved Custom Workload Report"",""view_access_type"":""public"",""project_access_type"":""specific_project"",""is_globally_accessible"":true,""determiner"":{""pattern"":""1 AND 2"",""criteria"":[{""module"":""workload"",""field_name"":""profiles"",""condition"":""contains"",""value"":[""1752587000000097269""]}]},""project"":{""id"":""4000000062001""},""shared_users"":[{""zpuid"":""4000000002055""}],""shared_projects"":[{""id"":""4000000062001""}],""group_by"":[{""field_name"":""users"",""module"":""workload"",""sort_by"":""asc""}],""view_period"":{""time_period"":""days"",""time_period_type"":""relative"",""relative_time_period"":""current_month"",""absolute_start_date"":""2026-07-01"",""absolute_end_date"":""2026-07-31""},""report_preference"":{""legend"":""allocatedhrs"",""view_type"":""heatmap"",""bar_type"":""gantt"",""show_option"":{""project_title"":""false"",""task_title"":""false""},""report_based_on"":""users""}}",
    Encoding.UTF8,
    "application/json"
);

var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

#include <iostream>
#include <string>
#include <curl/curl.h>

static size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* output) {
    output->append((char*)contents, size * nmemb);
    return size * nmemb;
}

int main() {
    CURL* curl = curl_easy_init();
    if (curl) {
        std::string response;
        struct curl_slist* headers = NULL;
        headers = curl_slist_append(headers, "Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");
        headers = curl_slist_append(headers, "Content-Type: application/json");

        curl_easy_setopt(curl, CURLOPT_URL, "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/custom-workload");
        curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
        curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "PUT");
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
        curl_easy_setopt(curl, CURLOPT_POSTFIELDS, "{\"id\":\"4000000062001\",\"module\":\"workload\",\"name\":\"Custom Reports Sheduled Export\",\"description\":\"My Saved Custom Workload Report\",\"view_access_type\":\"public\",\"project_access_type\":\"specific_project\",\"is_globally_accessible\":true,\"determiner\":{\"pattern\":\"1 AND 2\",\"criteria\":[{\"module\":\"workload\",\"field_name\":\"profiles\",\"condition\":\"contains\",\"value\":[\"1752587000000097269\"]}]},\"project\":{\"id\":\"4000000062001\"},\"shared_users\":[{\"zpuid\":\"4000000002055\"}],\"shared_projects\":[{\"id\":\"4000000062001\"}],\"group_by\":[{\"field_name\":\"users\",\"module\":\"workload\",\"sort_by\":\"asc\"}],\"view_period\":{\"time_period\":\"days\",\"time_period_type\":\"relative\",\"relative_time_period\":\"current_month\",\"absolute_start_date\":\"2026-07-01\",\"absolute_end_date\":\"2026-07-31\"},\"report_preference\":{\"legend\":\"allocatedhrs\",\"view_type\":\"heatmap\",\"bar_type\":\"gantt\",\"show_option\":{\"project_title\":\"false\",\"task_title\":\"false\"},\"report_based_on\":\"users\"}}");

        CURLcode res = curl_easy_perform(curl);
        if (res == CURLE_OK)
            std::cout << response << std::endl;
        else
            std::cerr << curl_easy_strerror(res) << std::endl;

        curl_slist_free_all(headers);
        curl_easy_cleanup(curl);
    }
    return 0;
}

(require '[clj-http.client :as client])

(def response
  (client/put "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/custom-workload"
    {:headers {"Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
                "Content-Type" "application/json"}
     :body "{\"id\":\"4000000062001\",\"module\":\"workload\",\"name\":\"Custom Reports Sheduled Export\",\"description\":\"My Saved Custom Workload Report\",\"view_access_type\":\"public\",\"project_access_type\":\"specific_project\",\"is_globally_accessible\":true,\"determiner\":{\"pattern\":\"1 AND 2\",\"criteria\":[{\"module\":\"workload\",\"field_name\":\"profiles\",\"condition\":\"contains\",\"value\":[\"1752587000000097269\"]}]},\"project\":{\"id\":\"4000000062001\"},\"shared_users\":[{\"zpuid\":\"4000000002055\"}],\"shared_projects\":[{\"id\":\"4000000062001\"}],\"group_by\":[{\"field_name\":\"users\",\"module\":\"workload\",\"sort_by\":\"asc\"}],\"view_period\":{\"time_period\":\"days\",\"time_period_type\":\"relative\",\"relative_time_period\":\"current_month\",\"absolute_start_date\":\"2026-07-01\",\"absolute_end_date\":\"2026-07-31\"},\"report_preference\":{\"legend\":\"allocatedhrs\",\"view_type\":\"heatmap\",\"bar_type\":\"gantt\",\"show_option\":{\"project_title\":\"false\",\"task_title\":\"false\"},\"report_based_on\":\"users\"}}"
     :as :json}))

(println (:body response))

package main

import (
    "fmt"
    "io"
    "net/http"
    "strings"
)

func main() {
    payload := strings.NewReader("{\"id\":\"4000000062001\",\"module\":\"workload\",\"name\":\"Custom Reports Sheduled Export\",\"description\":\"My Saved Custom Workload Report\",\"view_access_type\":\"public\",\"project_access_type\":\"specific_project\",\"is_globally_accessible\":true,\"determiner\":{\"pattern\":\"1 AND 2\",\"criteria\":[{\"module\":\"workload\",\"field_name\":\"profiles\",\"condition\":\"contains\",\"value\":[\"1752587000000097269\"]}]},\"project\":{\"id\":\"4000000062001\"},\"shared_users\":[{\"zpuid\":\"4000000002055\"}],\"shared_projects\":[{\"id\":\"4000000062001\"}],\"group_by\":[{\"field_name\":\"users\",\"module\":\"workload\",\"sort_by\":\"asc\"}],\"view_period\":{\"time_period\":\"days\",\"time_period_type\":\"relative\",\"relative_time_period\":\"current_month\",\"absolute_start_date\":\"2026-07-01\",\"absolute_end_date\":\"2026-07-31\"},\"report_preference\":{\"legend\":\"allocatedhrs\",\"view_type\":\"heatmap\",\"bar_type\":\"gantt\",\"show_option\":{\"project_title\":\"false\",\"task_title\":\"false\"},\"report_based_on\":\"users\"}}")
    req, _ := http.NewRequest("PUT", "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/custom-workload", payload)
    req.Header.Add("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")
    req.Header.Add("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

PUT https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/custom-workload HTTP/1.1
Host: https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/custom-workload
Authorization: Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa
Content-Type: application/json

{"id":"4000000062001","module":"workload","name":"Custom Reports Sheduled Export","description":"My Saved Custom Workload Report","view_access_type":"public","project_access_type":"specific_project","is_globally_accessible":true,"determiner":{"pattern":"1 AND 2","criteria":[{"module":"workload","field_name":"profiles","condition":"contains","value":["1752587000000097269"]}]},"project":{"id":"4000000062001"},"shared_users":[{"zpuid":"4000000002055"}],"shared_projects":[{"id":"4000000062001"}],"group_by":[{"field_name":"users","module":"workload","sort_by":"asc"}],"view_period":{"time_period":"days","time_period_type":"relative","relative_time_period":"current_month","absolute_start_date":"2026-07-01","absolute_end_date":"2026-07-31"},"report_preference":{"legend":"allocatedhrs","view_type":"heatmap","bar_type":"gantt","show_option":{"project_title":"false","task_title":"false"},"report_based_on":"users"}}

HttpClientBuilder httpClientBuilder = HttpClientBuilder.create();

SSLContext sslContext = SSLContext.getDefault();
SSLConnectionSocketFactory sslConnectionSocketFactory = new SSLConnectionSocketFactory(sslContext, NoopHostnameVerifier.INSTANCE);
CloseableHttpClient httpclient = httpClientBuilder.setSSLSocketFactory(sslConnectionSocketFactory).build();

URIBuilder uriBuilder = new URIBuilder("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/custom-workload");
HttpUriRequest requestObj = new HttpPut(uriBuilder.build());
requestObj.addHeader("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa");

HttpEntityEnclosingRequestBase requestBase = (HttpEntityEnclosingRequestBase) requestObj;
String requestBody = "{\"id\":\"4000000062001\",\"module\":\"workload\",\"name\":\"Custom Reports Sheduled Export\",\"description\":\"My Saved Custom Workload Report\",\"view_access_type\":\"public\",\"project_access_type\":\"specific_project\",\"is_globally_accessible\":true,\"determiner\":{\"pattern\":\"1 AND 2\",\"criteria\":[{\"module\":\"workload\",\"field_name\":\"profiles\",\"condition\":\"contains\",\"value\":[\"1752587000000097269\"]}]},\"project\":{\"id\":\"4000000062001\"},\"shared_users\":[{\"zpuid\":\"4000000002055\"}],\"shared_projects\":[{\"id\":\"4000000062001\"}],\"group_by\":[{\"field_name\":\"users\",\"module\":\"workload\",\"sort_by\":\"asc\"}],\"view_period\":{\"time_period\":\"days\",\"time_period_type\":\"relative\",\"relative_time_period\":\"current_month\",\"absolute_start_date\":\"2026-07-01\",\"absolute_end_date\":\"2026-07-31\"},\"report_preference\":{\"legend\":\"allocatedhrs\",\"view_type\":\"heatmap\",\"bar_type\":\"gantt\",\"show_option\":{\"project_title\":\"false\",\"task_title\":\"false\"},\"report_based_on\":\"users\"}}";
requestBase.setEntity(new StringEntity(requestBody, HTTP.UTF_8));

HttpResponse response = httpclient.execute(requestObj);

HttpEntity responseEntity = response.getEntity();
Object responseObject = EntityUtils.toString(responseEntity);
String responseString = responseObject.toString();

const url = 'https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/custom-workload';

const options = {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({"id":"4000000062001","module":"workload","name":"Custom Reports Sheduled Export","description":"My Saved Custom Workload Report","view_access_type":"public","project_access_type":"specific_project","is_globally_accessible":true,"determiner":{"pattern":"1 AND 2","criteria":[{"module":"workload","field_name":"profiles","condition":"contains","value":["1752587000000097269"]}]},"project":{"id":"4000000062001"},"shared_users":[{"zpuid":"4000000002055"}],"shared_projects":[{"id":"4000000062001"}],"group_by":[{"field_name":"users","module":"workload","sort_by":"asc"}],"view_period":{"time_period":"days","time_period_type":"relative","relative_time_period":"current_month","absolute_start_date":"2026-07-01","absolute_end_date":"2026-07-31"},"report_preference":{"legend":"allocatedhrs","view_type":"heatmap","bar_type":"gantt","show_option":{"project_title":"false","task_title":"false"},"report_based_on":"users"}})
};

fetch(url, options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error(error));

{"id":"4000000062001","module":"workload","name":"Custom Reports Sheduled Export","description":"My Saved Custom Workload Report","view_access_type":"public","project_access_type":"specific_project","is_globally_accessible":true,"determiner":{"pattern":"1 AND 2","criteria":[{"module":"workload","field_name":"profiles","condition":"contains","value":["1752587000000097269"]}]},"project":{"id":"4000000062001"},"shared_users":[{"zpuid":"4000000002055"}],"shared_projects":[{"id":"4000000062001"}],"group_by":[{"field_name":"users","module":"workload","sort_by":"asc"}],"view_period":{"time_period":"days","time_period_type":"relative","relative_time_period":"current_month","absolute_start_date":"2026-07-01","absolute_end_date":"2026-07-31"},"report_preference":{"legend":"allocatedhrs","view_type":"heatmap","bar_type":"gantt","show_option":{"project_title":"false","task_title":"false"},"report_based_on":"users"}}

import java.net.HttpURLConnection
import java.net.URL
import okhttp3.HttpUrl.Companion.toHttpUrl

fun main() {
    val url = URL("https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/custom-workload")
    val conn = url.openConnection() as HttpURLConnection
    conn.requestMethod = "PUT"
    conn.setRequestProperty("Authorization", "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa")
    conn.setRequestProperty("Content-Type", "application/json")
    conn.doOutput = true
    conn.outputStream.bufferedWriter().use { it.write("""{"id":"4000000062001","module":"workload","name":"Custom Reports Sheduled Export","description":"My Saved Custom Workload Report","view_access_type":"public","project_access_type":"specific_project","is_globally_accessible":true,"determiner":{"pattern":"1 AND 2","criteria":[{"module":"workload","field_name":"profiles","condition":"contains","value":["1752587000000097269"]}]},"project":{"id":"4000000062001"},"shared_users":[{"zpuid":"4000000002055"}],"shared_projects":[{"id":"4000000062001"}],"group_by":[{"field_name":"users","module":"workload","sort_by":"asc"}],"view_period":{"time_period":"days","time_period_type":"relative","relative_time_period":"current_month","absolute_start_date":"2026-07-01","absolute_end_date":"2026-07-31"},"report_preference":{"legend":"allocatedhrs","view_type":"heatmap","bar_type":"gantt","show_option":{"project_title":"false","task_title":"false"},"report_based_on":"users"}}""") }

    val response = conn.inputStream.bufferedReader().readText()
    println(response)
}

NSURL *url = [NSURL URLWithString:@"https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/custom-workload"];
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:url];
[request setHTTPMethod:@"PUT"];
[request setValue:@"Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa" forHTTPHeaderField:@"Authorization"];
[request setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];
NSData *body = [@"{\"id\":\"4000000062001\",\"module\":\"workload\",\"name\":\"Custom Reports Sheduled Export\",\"description\":\"My Saved Custom Workload Report\",\"view_access_type\":\"public\",\"project_access_type\":\"specific_project\",\"is_globally_accessible\":true,\"determiner\":{\"pattern\":\"1 AND 2\",\"criteria\":[{\"module\":\"workload\",\"field_name\":\"profiles\",\"condition\":\"contains\",\"value\":[\"1752587000000097269\"]}]},\"project\":{\"id\":\"4000000062001\"},\"shared_users\":[{\"zpuid\":\"4000000002055\"}],\"shared_projects\":[{\"id\":\"4000000062001\"}],\"group_by\":[{\"field_name\":\"users\",\"module\":\"workload\",\"sort_by\":\"asc\"}],\"view_period\":{\"time_period\":\"days\",\"time_period_type\":\"relative\",\"relative_time_period\":\"current_month\",\"absolute_start_date\":\"2026-07-01\",\"absolute_end_date\":\"2026-07-31\"},\"report_preference\":{\"legend\":\"allocatedhrs\",\"view_type\":\"heatmap\",\"bar_type\":\"gantt\",\"show_option\":{\"project_title\":\"false\",\"task_title\":\"false\"},\"report_based_on\":\"users\"}}" dataUsingEncoding:NSUTF8StringEncoding];
[request setHTTPBody:body];

NSURLSession *session = [NSURLSession sharedSession];
NSURLSessionDataTask *task = [session dataTaskWithRequest:request
    completionHandler:^(NSData *data, NSURLResponse *response, NSError *error) {
        NSString *result = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
        NSLog(@"%@", result);
}];
[task resume];

open Lwt
open Cohttp_lwt_unix

let () =
  let uri = Uri.of_string "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/custom-workload" in
  let headers = Cohttp.Header.init ()
    |> fun h -> Cohttp.Header.add h "Authorization" "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
    |> fun h -> Cohttp.Header.add h "Content-Type" "application/json"
  in
  let body = Cohttp_lwt.Body.of_string {json|{"id":"4000000062001","module":"workload","name":"Custom Reports Sheduled Export","description":"My Saved Custom Workload Report","view_access_type":"public","project_access_type":"specific_project","is_globally_accessible":true,"determiner":{"pattern":"1 AND 2","criteria":[{"module":"workload","field_name":"profiles","condition":"contains","value":["1752587000000097269"]}]},"project":{"id":"4000000062001"},"shared_users":[{"zpuid":"4000000002055"}],"shared_projects":[{"id":"4000000062001"}],"group_by":[{"field_name":"users","module":"workload","sort_by":"asc"}],"view_period":{"time_period":"days","time_period_type":"relative","relative_time_period":"current_month","absolute_start_date":"2026-07-01","absolute_end_date":"2026-07-31"},"report_preference":{"legend":"allocatedhrs","view_type":"heatmap","bar_type":"gantt","show_option":{"project_title":"false","task_title":"false"},"report_based_on":"users"}}|json} in
  Lwt_main.run (
    Client.put ~headers ~body uri >>= fun (_, body) ->
    Cohttp_lwt.Body.to_string body >|= fun s ->
    print_endline s)

$headers = @{
    "Authorization" = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"
    "Content-Type" = "application/json"
}

$body = @'
{"id":"4000000062001","module":"workload","name":"Custom Reports Sheduled Export","description":"My Saved Custom Workload Report","view_access_type":"public","project_access_type":"specific_project","is_globally_accessible":true,"determiner":{"pattern":"1 AND 2","criteria":[{"module":"workload","field_name":"profiles","condition":"contains","value":["1752587000000097269"]}]},"project":{"id":"4000000062001"},"shared_users":[{"zpuid":"4000000002055"}],"shared_projects":[{"id":"4000000062001"}],"group_by":[{"field_name":"users","module":"workload","sort_by":"asc"}],"view_period":{"time_period":"days","time_period_type":"relative","relative_time_period":"current_month","absolute_start_date":"2026-07-01","absolute_end_date":"2026-07-31"},"report_preference":{"legend":"allocatedhrs","view_type":"heatmap","bar_type":"gantt","show_option":{"project_title":"false","task_title":"false"},"report_based_on":"users"}}
'@

$response = Invoke-RestMethod -Uri "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/custom-workload" -Method PUT -Headers $headers -Body $body

$response | ConvertTo-Json

library(httr)

url <- "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/custom-workload"

response <- PUT(
  url,
  add_headers(Authorization = "Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa"),
  content_type_json(),
  body = "{\"id\":\"4000000062001\",\"module\":\"workload\",\"name\":\"Custom Reports Sheduled Export\",\"description\":\"My Saved Custom Workload Report\",\"view_access_type\":\"public\",\"project_access_type\":\"specific_project\",\"is_globally_accessible\":true,\"determiner\":{\"pattern\":\"1 AND 2\",\"criteria\":[{\"module\":\"workload\",\"field_name\":\"profiles\",\"condition\":\"contains\",\"value\":[\"1752587000000097269\"]}]},\"project\":{\"id\":\"4000000062001\"},\"shared_users\":[{\"zpuid\":\"4000000002055\"}],\"shared_projects\":[{\"id\":\"4000000062001\"}],\"group_by\":[{\"field_name\":\"users\",\"module\":\"workload\",\"sort_by\":\"asc\"}],\"view_period\":{\"time_period\":\"days\",\"time_period_type\":\"relative\",\"relative_time_period\":\"current_month\",\"absolute_start_date\":\"2026-07-01\",\"absolute_end_date\":\"2026-07-31\"},\"report_preference\":{\"legend\":\"allocatedhrs\",\"view_type\":\"heatmap\",\"bar_type\":\"gantt\",\"show_option\":{\"project_title\":\"false\",\"task_title\":\"false\"},\"report_based_on\":\"users\"}}"
)

content(response, "text")

import Foundation

let url = URL(string: "https://projects.zoho.com/api/v3/portal/[PORTAL_ID]/reports/custom-workload")!
var request = URLRequest(url: url)
request.httpMethod = "PUT"
request.setValue("Bearer 1000.03xxxxxxxxxxxxxxxxxa5317.dxxxxxxxxxxxxxxxxxfa", forHTTPHeaderField: "Authorization")
request.setValue("application/json", forHTTPHeaderField: "Content-Type")
request.httpBody = """
{"id":"4000000062001","module":"workload","name":"Custom Reports Sheduled Export","description":"My Saved Custom Workload Report","view_access_type":"public","project_access_type":"specific_project","is_globally_accessible":true,"determiner":{"pattern":"1 AND 2","criteria":[{"module":"workload","field_name":"profiles","condition":"contains","value":["1752587000000097269"]}]},"project":{"id":"4000000062001"},"shared_users":[{"zpuid":"4000000002055"}],"shared_projects":[{"id":"4000000062001"}],"group_by":[{"field_name":"users","module":"workload","sort_by":"asc"}],"view_period":{"time_period":"days","time_period_type":"relative","relative_time_period":"current_month","absolute_start_date":"2026-07-01","absolute_end_date":"2026-07-31"},"report_preference":{"legend":"allocatedhrs","view_type":"heatmap","bar_type":"gantt","show_option":{"project_title":"false","task_title":"false"},"report_based_on":"users"}}
""".data(using: .utf8)

let semaphore = DispatchSemaphore(value: 0)
let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data, let result = String(data: data, encoding: .utf8) {
        print(result)
    }
    semaphore.signal()
}
task.resume()
semaphore.wait()

Sample Input

Content-Type: application/json

{ "id" : "4000000062001", "module" : "workload", "name" : "Custom Reports Sheduled Export", "description" : "My Saved Custom Workload Report", "view_access_type" : "public", "project_access_type" : "specific_project", "is_globally_accessible" : true, "determiner" : { "pattern" : "1 AND 2", "criteria" : [ { "module" : "workload", "field_name" : "profiles", "condition" : "contains", "value" : [ "1752587000000097269" ] } ] }, "project" : { "id" : "4000000062001" }, "shared_users" : [ { "zpuid" : "4000000002055" } ], "shared_projects" : [ { "id" : "4000000062001" } ], "group_by" : [ { "field_name" : "users", "module" : "workload", "sort_by" : "asc" } ], "view_period" : { "time_period" : "days", "time_period_type" : "relative", "relative_time_period" : "current_month", "absolute_start_date" : "2026-07-01", "absolute_end_date" : "2026-07-31" }, "report_preference" : { "legend" : "allocatedhrs", "view_type" : "heatmap", "bar_type" : "gantt", "show_option" : { "project_title" : "false", "task_title" : "false" }, "report_based_on" : "users" } }

Sample Response

201{ "id" : "4000001117010", "name" : "My Saved View", "view_access_type" : "only_to_me", "project_access_type" : "specific_project", "is_view_specific_columns" : false, "is_default_view" : false, "is_globally_accessible" : true, "determiner" : { "pattern" : "1", "criteria" : [ { "field_name" : "owner", "condition" : "is", "value" : [ "4000000005170" ] } ] }, "shared_users" : [ ], "shared_projects" : [ ], "created_time" : "2026-07-10T11:52:04.246Z", "created_by" : { "zuid" : 18891770, "zpuid" : "4000000002143", "name" : "Monica", "email" : "monica.hemsworth@zylker.com", "first_name" : "Monica", "last_name" : "Hemsworth", "full_name" : "Monica Hemsworth" }, "updated_time" : "2026-07-10T11:52:04.246Z", "updated_by" : { "zuid" : 18891770, "zpuid" : "4000000002143", "name" : "Monica", "email" : "monica.hemsworth@zylker.com", "first_name" : "Monica", "last_name" : "Hemsworth", "full_name" : "Monica Hemsworth" }, "group_by" : [ { "field_name" : "users", "module" : "workload", "sort_by" : "asc" } ], "view_period" : { "time_period" : "days", "time_period_type" : "relative", "relative_time_period" : "current_month" }, "report_preference" : { "legend" : "allocatedhrs", "view_type" : "heatmap", "bar_type" : "gantt", "report_based_on" : "users" } }