# 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.

## Endpoints

GET `/dcapi/tools/suggestSearch`

## Request URL

```text
https://{server-hostname}:8383/dcapi/tools/suggestSearch
```

## Scope

`Tools.READ`

## Header

```text
Authorization: d92d4xxxxxxxxxxxxx15f52
```

## Request Parameters

### Request Headers

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

### Sample Request

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

## 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

### 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"
    }
  ]
}
```

## Possible Response Codes

- **200** `HTTP code`

![ ](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.