# Returns autocomplete search suggestions for computers and users on the Tools homepage

Returns search suggestions for computers and users based on the provided search value on the Tools homepage. Accepts 'searchValue', 'classID', and 'params' query parameters to narrow results.

## Endpoint

`GET /dcapi/tools/suggestSearch`

## Request

### Request URL

https://[{serverurl}](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)/dcapi/tools/suggestSearch

### Scope

`DesktopCentralCloud.Tools.READ`

### Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Request Headers

- **Accept** `string` — **Mandatory**
  - `application/json`

#### Query Parameters

- **searchValue** `string` — Optional
  - Keyword to search for. Matched against computer names and usernames on the Tools homepage
- **params** `string` — Optional
  - Additional search parameters encoded as a string to further filter search results

### Sample Request

```curl
curl --request GET \
  --url https://appdomains/dcapi/tools/suggestSearch \
  --header 'Accept: application/json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response

### Response Parameters

#### HTTP Code 200

Response Body — `application/json`

- `JSON Object`
  - **suggestions** `array`
    - Array of suggestion objects with type (computer/user), name, resourceId, and domainName

### Possible Response Codes

- **200** `HTTP code`

### Sample Response: HTTP 200

```json
{
  "suggestions": [
    {
      "resourceId": 101,
      "domainName": "CORP",
      "name": "WIN-DESKTOP-01",
      "type": "computer"
    },
    {
      "resourceId": 5001,
      "domainName": "CORP",
      "name": "john.doe",
      "type": "user"
    }
  ]
}
```

## Rate Limits

![](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**Duration:** 1 minute | **Threshold:** 30 | **Lock period:** 5 minutes

Duration - Time window for the threshold.  
Threshold - Number of API calls allowed within the specified duration.  
Lock Period - Wait time before consecutive API requests.