# Get search settings

URL: /docs/api/storefront/search/get-search-settings

The store's public instant-search settings for one locale: autocomplete limits and timing,
appearance, overlay, voice and analytics switches, and the localised placeholder and
no-results text. `meta.version` changes on every settings save (clear any suggestion cache
then). Cache it for 60 s; revalidate with `If-None-Match` for a bodyless `304`.

## GET /v1/search/config

```http
GET https://api.elaraone.app/api/v1/search/config
```

The store's public instant-search settings for one locale: autocomplete limits and timing,
appearance, overlay, voice and analytics switches, and the localised placeholder and
no-results text. `meta.version` changes on every settings save (clear any suggestion cache
then). Cache it for 60 s; revalidate with `If-None-Match` for a bodyless `304`.

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `locale` | query | string (nullable) |  | A store language code as listed in `data.locales[].code` (e.g. `en`, `fr`). Missing or unknown: the store default. |
| `X-Client-IP` | header | string |  | Optional. IP address of the shopper (one IPv4/IPv6, no port, no list). Honoured only together with a valid X-Tenant-Secret; ignored otherwise. Used for rate limits and recorded with form submissions. |
| `X-Tenant-Secret` | header | string |  | Optional here. Server secret of the store: server-to-server only, never from a browser. Enables X-Client-IP. |
| `If-None-Match` | header | string |  | Optional. The `ETag` of an answer you already hold. While it is still current the answer is `304 Not Modified` with no body (the `ETag` and `Cache-Control` headers are repeated); otherwise a normal 200 with the new `ETag`. |

### Responses

- **200**: Success.
- **304**: Not modified: the `ETag` sent in `If-None-Match` is still current. No body; keep using your copy.
- **402**: Payment required. Branch on `error.code`: - `TENANT_PAYMENT_REQUIRED`: this store is on payment hold. Show a "store temporarily unavailable" page; do not retry the request.
- **422**: Validation error