---
title: "Search the showroom designs"
method: GET
path: "/v3/showroom/design"
tags: ["Showroom"]
---

# Search the showroom designs

`GET /v3/showroom/design`

## Request

- Base URL: `https://api.rhinoartisan.com`
- URL: `https://api.rhinoartisan.com/v3/showroom/design`
- Auth: API key in header `apikey`
- TypeScript: <https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api/docs/v3/showroom/design/get.ts> (a function with typed inputs; its response is checked against the schema)

Designs of the published collections of the organization matching `q` (at least 2 characters, up to 60 results, best first). Every word must match, in any order, in the name, collections, type, badge, values (stone shape, metal…) or description; accents and case are ignored, Spanish words are understood (alianza, oro blanco, redondo…), prefixes match while typing and small typos are forgiven. Each one carries the published collection it is shown in, so the showroom can open it from there.

## Query parameters

- `q` string, required

## Response `200`

Matching designs, each with `collection: {id, name}`

- object[]

## Other responses

- `403`: Forbidden

## Changes

- **2026-10-15** `598bac108453`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api/changes/v3/showroom/design/get.md)

---

[API](https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api.md) - [All operations](https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api/revisions/f0e1d3d69cfb?raw)