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
Key | Datatype | Required | Description |
---|---|---|---|
from | string | Index number, starting from which the activities must be fetched, starts from 0 | |
limit | string | Number of activities to list | |
departmentId | string | ID 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> | |
id | string | ID of the activity <br>exact match <br> | |
subject | string | Subject of the activity <br>wildcard search <br> | |
ticketNumber | string | Serial number of the ticket associated with the activity <br>exact match <br> | |
status | string | Completion status of the activity <br>exact match <br> | |
priority | string | Priority of the activity <br>exact match <br> | |
assigneeId | string | ID of the agent assigned to handle the activity <br>exact match <br> | |
_all | string | Key that searches across all fields in all activities <br>wildcard search <br> | |
createdTimeRange | string | Key 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. | |
modifiedTimeRange | string | Key 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. | |
sortBy | string | SortBy can be: <br>relevance ,<br> <br>modifiedTime ,<br> <br>createdTime ,<br> |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Authorization | string |
RESPONSES
status: OK
{"data":[{"modifiedTime":"2016-09-13T12:14:41.000Z","ticket":null,"customFields":{},"subject":"Bug Fix #121","completedTime":null,"module":"task","departmentId":"3000000007043","dueDate":"2016-09-19T12:27:26.000Z","creatorId":"3000000008692","description":null,"ownerId":"3000000054002","priority":"High","isCommented":false,"createdTime":"2016-08-14T08:27:26.000Z","assignee":{"firstName":"","lastName":"jade","photoURL":"https://contacts.zoho.com/file?t=user\u0026ID=10657727","emailId":"jade@zylker.com","id":"5000000009116","zuid":"10657727"},"id":"3000000054004","department":{"name":"Testing","id":"5000000007235"},"category":null,"ticketId":null,"status":"Not Started"}],"count":1}