> ## Documentation Index > Fetch the complete documentation index at: https://developers.unbridaled.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get Calibrated Gemstone Filters > List the in-stock calibrated gemstones of a given shape, stone type, and type as a nested filter tree. Only gemstones with `quantity > 0` are returned. Prices are the merchant's wholesale prices: the US wholesale price list for US merchants and the default wholesale price list otherwise. ## Returns A `filters` object nested five levels deep — `shape` → `cut_code` → `type` → `size` → `quality` — where each leaf is the gemstone. - `size` is the stone length for `round` gemstones (e.g. `"3.0"`) and `"{length} x {width}"` for every other shape (e.g. `"5.0 x 3.0"`), in millimeters, formatted to one or two decimals. - `quality` is the calibrated gemstone quality grade — `AAA`, `AA`, `A`, or `B`. ## OpenAPI ````yaml get /api/v3/gemstones/get_calibrated_filters openapi: 3.1.0 info: title: Unbridaled Marketplace Merchant API v3 description: Developer API to integrate with Unbridaled Marketplace (v3) version: 3.0.0 servers: - url: https://api-staging.unbridaled.ai description: Sandbox API - description: Production API url: https://api.unbridaled.ai security: - apikeyAuth: [] tags: - name: Diamonds - name: Gemstones - name: Inventory - name: Orders - name: Product Variants - name: Products - name: Merchant Templates - name: Merchant Addresses - name: Profit Margins - name: Defaults paths: /api/v3/gemstones/get_calibrated_filters: get: tags: - Gemstones summary: Get Calibrated Gemstone Filters description: >- List the in-stock calibrated gemstones of a given shape, stone type, and type as a nested filter tree. Only gemstones with `quantity > 0` are returned. Prices are the merchant's wholesale prices: the US wholesale price list for US merchants and the default wholesale price list otherwise. ## Returns A `filters` object nested five levels deep — `shape` → `cut_code` → `type` → `size` → `quality` — where each leaf is the gemstone. - `size` is the stone length for `round` gemstones (e.g. `"3.0"`) and `"{length} x {width}"` for every other shape (e.g. `"5.0 x 3.0"`), in millimeters, formatted to one or two decimals. - `quality` is the calibrated gemstone quality grade — `AAA`, `AA`, `A`, or `B`. parameters: - name: shape in: query required: true schema: type: string description: >- Shape of the calibrated gemstones to list. See `Get Default Gem Attributes` for the supported values. - name: stone_type in: query required: true schema: type: string enum: - sapphire - ruby - emerald description: Stone type of the calibrated gemstones to list. - name: type in: query required: true schema: type: string enum: - mined - lab grown description: Type of the calibrated gemstones to list. responses: '200': description: OK content: application/json: schema: type: object properties: filters: type: object description: Calibrated gemstones keyed by shape. additionalProperties: type: object description: >- Keyed by cut code. Gemstones without a cut code are grouped under `brilliant_cut`. additionalProperties: type: object description: Keyed by type, `mined` or `lab grown`. additionalProperties: type: object description: >- Keyed by size in millimeters — length for round gemstones, `length x width` otherwise. additionalProperties: type: object description: Keyed by quality grade, `AAA`, `AA`, `A`, or `B`. additionalProperties: type: object properties: id: type: integer description: Internal identifier of the gemstone. sku: type: string description: >- SKU to use when placing an order for this gemstone. product_type: type: string description: >- Always `calibrated_gemstone` for this endpoint. type: type: string description: '`mined` or `lab grown`.' stone_type: type: string description: '`sapphire`, `ruby`, or `emerald`.' quality: type: string description: >- Same value as the `quality` key of this leaf. quantity: type: number description: Number of stones available. weight: type: number description: Weight of a single stone, in carats. wholesale_price: type: number description: Wholesale price per carat, in USD. wholesale_price_per_ct: type: number description: >- Same as `wholesale_price`; calibrated gemstones are priced per carat. tolerance_positive: type: number nullable: true description: Upper size tolerance, in millimeters. tolerance_negative: type: number nullable: true description: Lower size tolerance, in millimeters. days_to_return: type: integer nullable: true description: Days the merchant has to return the stone. memo_days_to_return: type: integer nullable: true description: >- Days to return when the stone is taken on memo. internal_days_to_return: type: integer nullable: true description: >- Days Unbridaled has to return the stone to its supplier. delivery_days_min: type: integer nullable: true description: Minimum delivery time in business days. delivery_days_max: type: integer nullable: true description: Maximum delivery time in business days. shape_icon_url: type: string nullable: true description: URL of the shape icon (SVG). shape_image_url: type: string nullable: true description: URL of the shape image (PNG). ux_url: type: string nullable: true description: >- URL of the 360 viewer, when media is available. cached_ux_url: type: string nullable: true description: Cached 360 viewer URL, when available. v360_json_base_url: type: string nullable: true description: Base URL of the 360 frame assets. v360_info: type: object nullable: true description: >- 360 media metadata (`frame_count`, `s3_path`, `md5_hash`, `image_ext`). is_sustainable: type: boolean nullable: true description: Whether the stone is flagged as sustainable. sustainability_details: type: object nullable: true description: Sustainability attributes, when set. example: filters: oval: brilliant_cut: mined: 5.0 x 3.0: AAA: id: 910233 sku: UB-CALGEM-1 product_type: calibrated_gemstone type: mined stone_type: sapphire quality: AAA quantity: 12 weight: 0.35 wholesale_price: 420 wholesale_price_per_ct: 420 tolerance_positive: 0.1 tolerance_negative: 0.1 days_to_return: 0 memo_days_to_return: 0 internal_days_to_return: 0 delivery_days_min: 1 delivery_days_max: 3 shape_icon_url: >- https://unbridaled-dev.s3.amazonaws.com/das/static/images/shape_icons/shape-oval.svg shape_image_url: >- https://unbridaled-dev.s3.amazonaws.com/das/static/images/shape_images/brilliant-oval.png ux_url: '' cached_ux_url: null v360_json_base_url: null v360_info: null is_sustainable: false sustainability_details: null '401': description: >- Missing or invalid token, or API access is not enabled for the merchant. content: application/json: schema: type: object properties: detail: type: string example: detail: API is not enabled for this merchant. '403': description: Token type is not allowed on this endpoint. '422': description: >- Invalid `shape`, `stone_type`, or `type` value, or a missing required parameter. components: securitySchemes: apikeyAuth: type: http scheme: bearer ````