Search Activities

GET {{baseUrl}}/api/v1/activities/search

This API searches for activities in your help desk portal.

OAuth Scope

  • Desk.search.READ
  • Desk.activities.calls.READ
  • Desk.activities.events.READ
  • Desk.activities.READ
  • Desk.activities.tasks.READ
  • Desk.calls.READ
  • Desk.tasks.READ
  • Desk.events.READ

Request Params

KeyDatatypeRequiredDescription
fromstringIndex number, starting from which the activities must be fetched, starts from 0
limitstringNumber of activities to list
departmentIdstringID of the department from which the activity must be fetched. If you do not pass a value for this parameter, the search is performed in all permitted departments. <br>exact match<br>
idstringID of the activity <br>exact match<br>
subjectstringSubject of the activity <br>wildcard search<br>
ticketNumberstringSerial number of the ticket associated with the activity <br>exact match<br>
statusstringCompletion status of the activity <br>exact match<br>
prioritystringPriority of the activity <br>exact match<br>
assigneeIdstringID of the agent assigned to handle the activity <br>exact match<br>
_allstringKey that searches across all fields in all activities <br>wildcard search<br>
createdTimeRangestringKey that filters activities created in a particular period of time. Enter the from and to dates in the ISO date format of yyyy-MM-ddThh:mm:ss.SSSZ; for example, createdTimeRange=2017-11-05T00:00:00.000Z,2018-09-05T23:59:00.000Z.
modifiedTimeRangestringKey that filters activities whose details were modified in a particular period of time. Enter the from and to dates in the ISO date format of yyyy-MM-ddThh:mm:ss.SSSZ; for example, modifiedTimeRange=2017-11-05T00:00:00.000Z,2018-09-05T23:59:00.000Z.
sortBystringSortBy can be: <br>relevance,<br> <br>modifiedTime,<br> <br>createdTime,<br>

HEADERS

KeyDatatypeRequiredDescription
Authorizationstring

RESPONSES

status: OK

{&quot;data&quot;:[{&quot;modifiedTime&quot;:&quot;2016-09-13T12:14:41.000Z&quot;,&quot;ticket&quot;:null,&quot;customFields&quot;:{},&quot;subject&quot;:&quot;Bug Fix #121&quot;,&quot;completedTime&quot;:null,&quot;module&quot;:&quot;task&quot;,&quot;departmentId&quot;:&quot;3000000007043&quot;,&quot;dueDate&quot;:&quot;2016-09-19T12:27:26.000Z&quot;,&quot;creatorId&quot;:&quot;3000000008692&quot;,&quot;description&quot;:null,&quot;ownerId&quot;:&quot;3000000054002&quot;,&quot;priority&quot;:&quot;High&quot;,&quot;isCommented&quot;:false,&quot;createdTime&quot;:&quot;2016-08-14T08:27:26.000Z&quot;,&quot;assignee&quot;:{&quot;firstName&quot;:&quot;&quot;,&quot;lastName&quot;:&quot;jade&quot;,&quot;photoURL&quot;:&quot;https://contacts.zoho.com/file?t=user\u0026ID=10657727&quot;,&quot;emailId&quot;:&quot;jade@zylker.com&quot;,&quot;id&quot;:&quot;5000000009116&quot;,&quot;zuid&quot;:&quot;10657727&quot;},&quot;id&quot;:&quot;3000000054004&quot;,&quot;department&quot;:{&quot;name&quot;:&quot;Testing&quot;,&quot;id&quot;:&quot;5000000007235&quot;},&quot;category&quot;:null,&quot;ticketId&quot;:null,&quot;status&quot;:&quot;Not Started&quot;}],&quot;count&quot;:1}