---
title: "Resolve v1"
method: GET
path: "/v1/search/resolve"
tags: ["search-v1"]
---

# Resolve v1

`GET /v1/search/resolve`

This endpoint is intended to provide one best match.

The request needs to match at least one category and one attribute.
For example, searching for `pants black denim useless` would return category `pants`
that have two attributes: `black` and `denim`. The `useless` will be discarded. If the best match was found, it will return the relevant result; otherwise, it will return nothing.

A detailed explanation of the functionality can be found in [SCAYLE Panel developer guide](/en/developer-guide/products/search#resolve)

## Query parameters

- `term` string, required
- `categoryId` integer

## Response `200`

successful operation

- SearchResolveResponse
  - `matches` ResolveMatch[]
    - `count` integer
    - `match` string
    - `category` object
      - `match` string
      - `id` integer
      - `name` string
    - `attributes` object[]
      - `match` string
      - `name` string
      - `attributeGroup` integer
      - `attributeId` integer

## Other responses

- `400` — term not provided
- `401` — authentication failed
- `422` — formal validation failure (see schema)

## Changes

- **2026-07-17** `8cfa924ae703` — 2 info
  - api tag `search-v1` added
  - api tag `search` removed
- **2023-08-21** `beabe2149947` — 2 info
  - added the new optional `query` request parameter `categoryId`
  - added the non-success response with the status `422`
- **2023-08-06** `302b7c443b51` — 1 warning, 3 info
  - deleted the `query` request parameter `categoryId`
  - api tag `search` added
  - api tag `search-v1` removed
  - removed the non-success response with the status `422`

[Change history](https://skmtc.dev/scayle/apis/storefront-api-documentation/changes/v1/search/resolve/get.md)

---

[API](https://skmtc.dev/scayle/apis/storefront-api-documentation.md) · [All operations](https://skmtc.dev/scayle/apis/storefront-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scayle/storefront-api-documentation/revisions/8cfa924ae703/schema)