---
title: "Simulate a design's price breakdown against a manufacturer"
method: POST
path: "/v3/backoffice/simulator"
tags: ["Simulator"]
---

# Simulate a design's price breakdown against a manufacturer

`POST /v3/backoffice/simulator`

## Request

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

Computes the price breakdown of a design (from the tech data the engine produced) using any manufacturer of the organization and, optionally, a diamond group and a target currency.

## Request body

- object
  - `design_id` integer, required
  - `manufacturer_id` integer, required
  - `group_id` integer, nullable: Diamond group, optional
  - `currency` string, nullable
  - `main_stone_cost` number, nullable: Cost of the main stone, in the breakdown currency, to try the dynamic setting markup (its share of the raw cost picks the tier). Omitted: the stone put in the design, if any

## Response `200`

Breakdown (metals, gems, processes, markup, delivery), `retail` {setting_cost, markup_mode, markup_percentage, markup_tier, main_stone_cost, main_stone_share, markup_amount, total, currency} with the active markup (null without one), plus `design` {id, name, preview}

## Other responses

- `400`: INVALID_DATA | MISSING_DESIGN_ID | MISSING_MANUFACTURER_ID | DESIGN_NOT_COMPUTED
- `404`: DESIGN_NOT_FOUND | MANUFACTURER_NOT_FOUND | DIAMOND_GROUP_NOT_FOUND

## Changes

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

[Operation history](https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api/changes/v3/backoffice/simulator/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)