Get Currently Running Timer API

This API is used to get the currently running timer details

Request URL:

https://people.zoho.com/people/api/timetracker/getcurrentlyrunningtimer?dateFormat=<dateFormat>

Header:

Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxx9be93.9b8xxxxxxf

Scope:

ZOHOPEOPLE.timetracker.ALL
OR
ZOHOPEOPLE.timetracker.READ 

Possible Operation Types:

ALL - Complete access to data
DELETE - Only to delete data

Success Response Format

{
    "response": {
        "result": { (Note: This key exists only when there is a timer running currently)
            "jobName": < job name >
            "date": < current time (in secs) >,
            "hours": < hours in mins >,
            "erecno": < erecno >,
            "diff": < difference (in secs) between timer start time & current time >,
            "billingStatus": < billable | nonbillable >
            "timerId": < currently running timer's id >,
            "jobId": < jobId >,
            "workDate": < date in yyyy-mm-dd >,
            "totaltime": < total hours(in sec) logged for the timelog whose timer is running >,
            "isRunning": true,
            "timelogId": < timelog id containing the running timer >,
            "fromTime": < running timer's start time in sec >,
            "taskName": < workitem >,
            "employeename": < employee name >,
        },
        "message": "Running Timer information fetched successfully",
        "uri": "/api/timetracker/getcurrentlyrunningtimer",
        "status": 0
    }
}

Threshold Limit: 20 requests | Lock period: 5 minutes

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

Sample Request

Copiedhttps://people.zoho.com/people/api/timetracker/getcurrentlyrunningtimer?

Header

CopiedAuthorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxx9be93.9b8xxxxxxf

Sample Response

JsonXML
Copied{
    "response": {
        "result": {
            "jobName": "UI designing",
            "date": 60574,
            "hours": 241,
            "erecno": "492688000000142191",
            "diff": 573,
            "billingStatus": "billable",
            "timerId": "492688000000820013",
            "jobId": "492688000000790013",
            "workDate": "2019-04-06",
            "totaltime": 14495,
            "isRunning": true,
            "timelogId": "492688000000821095",
            "fromTime": 60001,
            "taskName": "",
            "jobIsActive": true,
            "employeename": "Christine Spalding",
            "isCompleted": 0
        },
        "message": "Running Timer information fetched successfully",
        "uri": "/api/timetracker/getcurrentlyrunningtimer",
        "status": 0
    }
}
Copied<?xml version="1.0" encoding="UTF-8"?>
<response uri="/api/timetracker/getcurrentlyrunningtimer">
<status>0</status>
<message>Running Timer information fetched successfully</message>
<result>
	<timer>
		<date>60635</date>
		<hours>241</hours>
		<jobName>UI designing</jobName>
		<erecno>492688000000142191</erecno>
		<diff>634</diff>
		<billingStatus>billable</billingStatus>
		<timerId>492688000000820013</timerId>
		<jobId>492688000000790013</jobId>
		<workDate>2019-04-06</workDate>
		<totaltime>14495</totaltime>
		<isRunning>true</isRunning>
		<timelogId>492688000000821095</timelogId>
		<fromTime>60001</fromTime>
		<taskName></taskName>
		<jobIsActive>true</jobIsActive>
		<employeename>amutha</employeename>
		<isCompleted>0</isCompleted>
	</timer>
</result>
</response>