Get my pending approvals

GET {{baseUrl}}/api/v1/myPendingApprovals?department=<String>

This API lists the pending approvals for a given user

OAuth Scope

  • Desk.settings.READ

Request Params

KeyDatatypeRequiredDescription
fromstringIndex number, starting from which the pending approvals for a give user must be fetched.
departmentstringID of the department from which pending approvals must be fetched. You can pass a specific department ID or allDepartment in the API request.
limitstringNumber of pending approvals to list
sortBystringSort by a specific attribute: createdTime. The default sorting order is ascending. A - prefix denotes descending order of sorting.

HEADERS

KeyDatatypeRequiredDescription
Authorizationstring

RESPONSES

status: OK

{&quot;myPendingApprovals&quot;:[{&quot;departmentName&quot;:&quot;Sales&quot;,&quot;requester&quot;:{&quot;firstName&quot;:&quot;&quot;,&quot;lastName&quot;:&quot;Smith&quot;,&quot;photoURL&quot;:&quot;https://desk.zoho.com/api/v1/agent/5000000012902/photo&quot;,&quot;id&quot;:&quot;5000000012902&quot;,&quot;email&quot;:null},&quot;ticketNumber&quot;:&quot;102&quot;,&quot;subject&quot;:&quot;Sample subject&quot;,&quot;departmentId&quot;:&quot;4000000019077&quot;,&quot;createdTime&quot;:&quot;2019-06-21T13:16:14.000Z&quot;,&quot;description&quot;:&quot;Sample description&quot;,&quot;id&quot;:&quot;4000002350527&quot;,&quot;ticketId&quot;:&quot;4000002350527&quot;},{&quot;departmentName&quot;:&quot;Marketing&quot;,&quot;requester&quot;:{&quot;firstName&quot;:&quot;&quot;,&quot;lastName&quot;:&quot;John&quot;,&quot;photoURL&quot;:&quot;https://desk.zoho.com/api/v1/agent/5000000012932/photo&quot;,&quot;id&quot;:&quot;5000000012932&quot;,&quot;email&quot;:null},&quot;ticketNumber&quot;:&quot;102&quot;,&quot;subject&quot;:&quot;Sample subject&quot;,&quot;departmentId&quot;:&quot;4000000019067&quot;,&quot;createdTime&quot;:&quot;2019-06-21T13:16:14.000Z&quot;,&quot;description&quot;:&quot;&quot;,&quot;id&quot;:&quot;4000002350527&quot;,&quot;ticketId&quot;:&quot;4000000014335&quot;}],&quot;assignee&quot;:{&quot;firstName&quot;:&quot;John&quot;,&quot;lastName&quot;:&quot;Carol&quot;,&quot;photoURL&quot;:&quot;https://desk.zoho.com/api/v1/agents/1892000000056007/photo&quot;,&quot;id&quot;:&quot;1892000000056007&quot;,&quot;email&quot;:&quot;carol@zylker.com&quot;}}