---
title: "List items by similarity score range"
method: GET
path: "/items/similarity"
tags: ["items"]
---

# List items by similarity score range

`GET /items/similarity`

Returns items that have at least one similarity relationship with a score

## Query parameters

- `min_score` number, required
- `max_score` number, required
- `limit` integer
- `offset` integer

## Response `200`

OK

- HandlersSimilarityItemsResponse
  - `business_id` string
  - `items` ServicesSimilarityListItem[]
    - `business_id` string
    - `internal_code` string — drawing internal code (Kacher-test); shown as the small identifier line
    - `item_id` string
    - `manufacturer` string
    - `max_score` number — highest SIMILARITY score
    - `part_number` string
    - `reviewed_count` integer — ReviewedCount is how many of THOSE matches carry a human verdict. It is a pointer, and omitted entirely, for businesses whose verdicts this endpoint does not count — a plain 0 there would render as "0/M reviewed" and state that nothing has been reviewed, which is a stronger claim than "we did not look" and is false for any tenant whose reviewers have been labelling.
    - `similar_count` integer — number of items above threshold
    - `title` string
  - `limit` integer
  - `offset` integer
  - `total` integer

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `503` — Neo4j service not available

---

[API](https://skmtc.net/resourcly/apis/resourcly-api.md) · [All operations](https://skmtc.net/resourcly/apis/resourcly-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/resourcly/resourcly-api/revisions/7f97d8cd0f1e/schema)