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.
sizeis the stone length forroundgemstones (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.qualityis the calibrated gemstone quality grade —AAA,AA,A, orB.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Shape of the calibrated gemstones to list. See Get Default Gem Attributes for the supported values.
Stone type of the calibrated gemstones to list.
sapphire, ruby, emerald Type of the calibrated gemstones to list.
mined, lab grown Response
OK
Calibrated gemstones keyed by shape.