--- title: Autocomplete API handler slug: configured-commerce/docs/autocomplete-api-handler docTags: createdAt: 2026-08-13T10:46:21.000Z --- **HTTP Verb** – GET **URL** – /api/v1/autocomplete /api/v1/autocomplete/products **Description** – Query products by partial search criteria **Base** – HandlerBase\ **Handlers** – | Order | Handler | Description | | ----- | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 500 | GetAutocompleteProductCollectionHandler | Gets product collection for autocomplete. If requester is not signed in and website setting WebSiteNavigation set to 'SignInRequiredToBrowse' then handler return error result. Also if requester restricted from website then handler return error result. **NOTE** – This handler was obsolesced as of version 4.3.1 and subsequent version should use the /api/v1/autocomplete endpoint in its place. | | Order | Handler | Description | | ----- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 500 | GetAutocompleteProductResults | Retrieves autocomplete product results from Elasticsearch using a query. If any of the following is "true", this handler is skipped.
The Autocomplete "Show Products" setting equals "false"
The ProductEnabled property on the parameter object equals "false"
The Query property on the parameter object is blank
Uses the GetProductSettingsHandler handler chain to retrieve product search settings. If the CanSeeProducts property on the settings object equals "false", an error is returned (the current user cannot search for or see products).

The product results are stored in the Products property on the result object. | | 600 | GetAutocompleteContentResults | Retrieves autocomplete content page results from Elasticsearch. If any of the following is "true", this handler is skipped.
The Autocomplete "Show Website Pages" setting equals "false"
The ContentEnabled property on the parameter object equals "false"
The Query property on the parameter object is blank
The content page results are stored in the Content property on the result object. | | 700 | GetAutocompleteCategoryResults | Retrieves autocomplete category results from Elasticsearch. If any of the following is "true", this handler is skipped.
The Autocomplete "Show Categories" setting equals "false"
The CategoryEnabled property on the parameter object equals "false"
The Query property on the parameter object is blank
The category results are stored in the Categories property on the result object. |