---
title: "Search the store diamonds of an organization"
method: POST
path: "/v3/public/webcomponent/diamond/search"
tags: ["Public Webcomponent"]
---

# Search the store diamonds of an organization

`POST /v3/public/webcomponent/diamond/search`

## Request

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

Filtered, paginated search over every diamond of the organization identified by the apikey header (all its groups). Prices are retail (markup applied). Public endpoint intended for embeddable webcomponents.

## Headers

- `apikey` string, required

## Request body

- object
  - `shapes` string[], nullable
  - `types` string[], nullable
  - `labs` string[], nullable: GIA, IGI, GCAL…
  - `cut` string[], nullable
  - `color` string[], nullable
  - `clarity` string[], nullable
  - `carat_min` number, nullable
  - `carat_max` number, nullable
  - `price_min` number, nullable: Over the retail price
  - `price_max` number, nullable: Over the retail price
  - `sort_mode` 'price-asc' | 'price-desc' | 'date-asc' | 'date-desc' | 'carat-asc' | 'carat-desc' | 'color-asc' | 'color-desc', nullable
  - `page` integer, nullable
  - `page_size` integer, nullable

## Response `200`

Paginated diamonds with retail prices

- object
  - `total` integer
  - `page` integer
  - `page_size` integer
  - `items` object[]

## Other responses

- `400`: NO_ACTIVE_MARKUP
- `403`: INVALID_APIKEY

## Changes

- **2026-10-02** `82c79770c36b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api/changes/v3/public/webcomponent/diamond/search/post.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)