{
"detail": "API is not enabled for this merchant."
}
Diamonds
Get Melee Parcel Filters
List the in-stock melee diamond parcels of a given shape and type as a nested filter tree.
Only parcels 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 parcel.
size is the stone length for round parcels (e.g. "1.3") and "{length} x {width}" for every other shape (e.g. "3.5 x 2.75"), in millimeters, formatted to one or two decimals.
quality is "{color_max}-{color}/{clarity_max}-{clarity}" (e.g. "F-D/VS2-VS1") — the color and clarity range of the stones in the parcel.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Unbridaled Developer Hub","colors":{"primary":"#9563FF","light":"#AE87FF","dark":"#0D001D"},"logo":{"light":"https://mintcdn.com/unbridaled/DSmz57bAj0BM8SXg/logo/light.svg?fit=max\u0026auto=format\u0026n=DSmz57bAj0BM8SXg\u0026q=85\u0026s=d023a18380556ff4aaeccbfd6e1921e2","dark":"https://mintcdn.com/unbridaled/DSmz57bAj0BM8SXg/logo/dark.svg?fit=max\u0026auto=format\u0026n=DSmz57bAj0BM8SXg\u0026q=85\u0026s=b26b72ddad85467da63bc94ff02062ea"},"favicon":"https://mintcdn.com/unbridaled/DSmz57bAj0BM8SXg/ub-favicon.png?fit=max\u0026auto=format\u0026n=DSmz57bAj0BM8SXg\u0026q=85\u0026s=9761c736f6bba926fe16465309ff3161","background":{"color":{"dark":"#090014"}},"navbar":{"links":[{"href":"mailto:[email protected]","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.unbridaled.ai"}},"footer":{"socials":{"twitter":"https://twitter.com/unbridaled_ai","github":"https://github.com/unbridaled","linkedin":"https://www.linkedin.com/company/unbridaled-ai"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"unbridaled","hasAudioNarration":false,"actualSubdomain":"unbridaled","customDomains":["developers.unbridaled.ai"],"gitSource":{"type":"github","owner":"unbridaled","repo":"mintlify-docs","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a739eef91c5a3b364361d45","collectionId":"36909d54-e31e-4c93-a8d2-cef3eb138ce1","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a739eef91c5a3b364361d45"},"entitlements":{},"buildId":"6a739eef91c5a3b364361d45:success","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"Documentation","count":36},{"language":"default","tag":"API Reference","count":36},{"language":"default","tag":"Defaults","count":10},{"language":"default","tag":"Orders","count":6},{"language":"default","tag":"Diamonds","count":5},{"language":"default","tag":"Profit Margins","count":4},{"language":"default","tag":"Inventory","count":2},{"language":"default","tag":"Merchant Addresses","count":2},{"language":"default","tag":"Merchant Templates","count":2},{"language":"default","tag":"Product Variants","count":2}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/v3/diamonds/get-melee-parcel-filters","slug":"/api-reference/v3/diamonds/get-melee-parcel-filters","pageMetadata":{"openapi":"get /api/v3/diamonds/get_parcel_filters","title":"Get Melee Parcel Filters","description":"List the in-stock melee diamond parcels of a given shape and type as a nested filter tree.\n\nOnly parcels 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.\n\n## Returns\n\nA `filters` object nested five levels deep — `shape` → `cut_code` → `type` → `size` → `quality` — where each leaf is the parcel.\n\n- `size` is the stone length for `round` parcels (e.g. `\"1.3\"`) and `\"{length} x {width}\"` for every other shape (e.g. `\"3.5 x 2.75\"`), in millimeters, formatted to one or two decimals.\n- `quality` is `\"{color_max}-{color}/{clarity_max}-{clarity}\"` (e.g. `\"F-D/VS2-VS1\"`) — the color and clarity range of the stones in the parcel.","href":"/api-reference/v3/diamonds/get-melee-parcel-filters"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n h2: \"h2\",\n li: \"li\",\n p: \"p\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"List the in-stock melee diamond parcels of a given shape and type as a nested filter tree.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Only parcels with \", _jsx(_components.code, {\n children: \"quantity > 0\"\n }), \" are returned. Prices are the merchant’s wholesale prices: the US wholesale price list for US merchants and the default wholesale price list otherwise.\"]\n }), \"\\n\", _jsx(_components.h2, {\n children: \"Returns\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"A \", _jsx(_components.code, {\n children: \"filters\"\n }), \" object nested five levels deep — \", _jsx(_components.code, {\n children: \"shape\"\n }), \" → \", _jsx(_components.code, {\n children: \"cut_code\"\n }), \" → \", _jsx(_components.code, {\n children: \"type\"\n }), \" → \", _jsx(_components.code, {\n children: \"size\"\n }), \" → \", _jsx(_components.code, {\n children: \"quality\"\n }), \" — where each leaf is the parcel.\"]\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"size\"\n }), \" is the stone length for \", _jsx(_components.code, {\n children: \"round\"\n }), \" parcels (e.g. \", _jsx(_components.code, {\n children: \"\\\"1.3\\\"\"\n }), \") and \", _jsx(_components.code, {\n children: \"\\\"{length} x {width}\\\"\"\n }), \" for every other shape (e.g. \", _jsx(_components.code, {\n children: \"\\\"3.5 x 2.75\\\"\"\n }), \"), in millimeters, formatted to one or two decimals.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"quality\"\n }), \" is \", _jsx(_components.code, {\n children: \"\\\"{color_max}-{color}/{clarity_max}-{clarity}\\\"\"\n }), \" (e.g. \", _jsx(_components.code, {\n children: \"\\\"F-D/VS2-VS1\\\"\"\n }), \") — the color and clarity range of the stones in the parcel.\"]\n }), \"\\n\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"get /api/v3/diamonds/get_parcel_filters","title":"Get Melee Parcel Filters","description":"List the in-stock melee diamond parcels of a given shape and type as a nested filter tree.\n\nOnly parcels 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.\n\n## Returns\n\nA `filters` object nested five levels deep — `shape` → `cut_code` → `type` → `size` → `quality` — where each leaf is the parcel.\n\n- `size` is the stone length for `round` parcels (e.g. `\"1.3\"`) and `\"{length} x {width}\"` for every other shape (e.g. `\"3.5 x 2.75\"`), in millimeters, formatted to one or two decimals.\n- `quality` is `\"{color_max}-{color}/{clarity_max}-{clarity}\"` (e.g. `\"F-D/VS2-VS1\"`) — the color and clarity range of the stones in the parcel.","href":"/api-reference/v3/diamonds/get-melee-parcel-filters"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Diamonds"],"summary":"Get Melee Parcel Filters","description":"List the in-stock melee diamond parcels of a given shape and type as a nested filter tree.\n\nOnly parcels 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.\n\n## Returns\n\nA `filters` object nested five levels deep — `shape` → `cut_code` → `type` → `size` → `quality` — where each leaf is the parcel.\n\n- `size` is the stone length for `round` parcels (e.g. `\"1.3\"`) and `\"{length} x {width}\"` for every other shape (e.g. `\"3.5 x 2.75\"`), in millimeters, formatted to one or two decimals.\n- `quality` is `\"{color_max}-{color}/{clarity_max}-{clarity}\"` (e.g. `\"F-D/VS2-VS1\"`) — the color and clarity range of the stones in the parcel.","parameters":["38815a88-1dfb-4298-9c1b-b22d05a4875e","323c2507-cd93-4ad2-85c5-a34fdc370b9e"],"responses":{"200":"c0aea3b2-03d3-49c7-a17b-fb7d474abafa","401":"9c1a1e4a-979b-4c60-bc7e-de27f3fbe208","403":"2d27f0ed-96ea-41e5-8595-a46601f1dc3c","422":"548dbed6-ee2a-4ef2-932b-d1b1a2a7a6bf"},"method":"get","type":"path","servers":["39d3dfe0-00de-411f-93fb-df6d227984e7","a9ab9bb5-7ffd-4d53-9f9f-039701667d4d"],"security":["94968659-f772-404e-8c1e-0c5cced6fb6d"],"path":"/api/v3/diamonds/get_parcel_filters","baseUrlOptions":["https://api-staging.unbridaled.ai","https://api.unbridaled.ai"],"title":"Get Melee Parcel Filters","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"38815a88-1dfb-4298-9c1b-b22d05a4875e":{"name":"shape","in":"query","required":false,"schema":{"type":"string","default":"round","isRequired":false,"description":"Shape of the melee parcels to list. Defaults to `round`. See `Get Default Gem Attributes` for the supported values.","uniqueKey":"","typeLabel":"string"},"description":"Shape of the melee parcels to list. Defaults to `round`. See `Get Default Gem Attributes` for the supported values."},"323c2507-cd93-4ad2-85c5-a34fdc370b9e":{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["mined","lab grown"],"default":"mined","isRequired":false,"description":"Type of the melee parcels to list. Defaults to `mined`.","uniqueKey":"","typeLabel":"enum\u003cstring>"},"description":"Type of the melee parcels to list. Defaults to `mined`."}},"responses":{"c0aea3b2-03d3-49c7-a17b-fb7d474abafa":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"filters":{"type":"object","description":"Melee parcels keyed by shape.","additionalProperties":{"type":"object","description":"Keyed by cut code, e.g. `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 parcels, `length x width` otherwise.","additionalProperties":{"type":"object","description":"Keyed by quality, `{color_max}-{color}/{clarity_max}-{clarity}`.","additionalProperties":{"type":"object","properties":{"id":{"type":"integer","description":"Internal identifier of the parcel.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.id","typeLabel":"integer"},"sku":{"type":"string","description":"SKU to use when placing an order for this parcel.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.sku","typeLabel":"string"},"product_type":{"type":"string","description":"Always `melee` for this endpoint.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.product_type","typeLabel":"string"},"type":{"type":"string","description":"`mined` or `lab grown`.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.type","typeLabel":"string"},"stone_type":{"oneOf":[{"type":"string","description":"Always `null` for melee diamonds.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.stone_type.oneOf.0","typeLabel":"string"},{"type":"null","description":"Always `null` for melee diamonds.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.stone_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.stone_type","typeLabel":"string | null"},"quality":{"type":"string","description":"Same value as the `quality` key of this leaf.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.quality","typeLabel":"string"},"quantity":{"type":"number","description":"Number of stones available in the parcel.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.quantity","typeLabel":"number"},"weight":{"type":"number","description":"Weight of a single stone, in carats.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.weight","typeLabel":"number"},"wholesale_price":{"type":"number","description":"Wholesale price per carat, in USD.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.wholesale_price","typeLabel":"number"},"wholesale_price_per_ct":{"type":"number","description":"Same as `wholesale_price`; melee is priced per carat.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.wholesale_price_per_ct","typeLabel":"number"},"tolerance_positive":{"oneOf":[{"type":"number","description":"Upper size tolerance of the parcel, in millimeters.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.tolerance_positive.oneOf.0","typeLabel":"number"},{"type":"null","description":"Upper size tolerance of the parcel, in millimeters.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.tolerance_positive.oneOf.1","typeLabel":"null"}],"uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.tolerance_positive","typeLabel":"number | null"},"tolerance_negative":{"oneOf":[{"type":"number","description":"Lower size tolerance of the parcel, in millimeters.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.tolerance_negative.oneOf.0","typeLabel":"number"},{"type":"null","description":"Lower size tolerance of the parcel, in millimeters.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.tolerance_negative.oneOf.1","typeLabel":"null"}],"uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.tolerance_negative","typeLabel":"number | null"},"days_to_return":{"oneOf":[{"type":"integer","description":"Days the merchant has to return the parcel.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.days_to_return.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Days the merchant has to return the parcel.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.days_to_return.oneOf.1","typeLabel":"null"}],"uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.days_to_return","typeLabel":"integer | null"},"memo_days_to_return":{"oneOf":[{"type":"integer","description":"Days to return when the parcel is taken on memo.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.memo_days_to_return.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Days to return when the parcel is taken on memo.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.memo_days_to_return.oneOf.1","typeLabel":"null"}],"uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.memo_days_to_return","typeLabel":"integer | null"},"internal_days_to_return":{"oneOf":[{"type":"integer","description":"Days Unbridaled has to return the parcel to its supplier.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.internal_days_to_return.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Days Unbridaled has to return the parcel to its supplier.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.internal_days_to_return.oneOf.1","typeLabel":"null"}],"uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.internal_days_to_return","typeLabel":"integer | null"},"delivery_days_min":{"oneOf":[{"type":"integer","description":"Minimum delivery time in business days.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.delivery_days_min.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Minimum delivery time in business days.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.delivery_days_min.oneOf.1","typeLabel":"null"}],"uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.delivery_days_min","typeLabel":"integer | null"},"delivery_days_max":{"oneOf":[{"type":"integer","description":"Maximum delivery time in business days.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.delivery_days_max.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Maximum delivery time in business days.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.delivery_days_max.oneOf.1","typeLabel":"null"}],"uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.delivery_days_max","typeLabel":"integer | null"},"shape_icon_url":{"oneOf":[{"type":"string","description":"URL of the shape icon (SVG).","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.shape_icon_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"URL of the shape icon (SVG).","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.shape_icon_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.shape_icon_url","typeLabel":"string | null"},"shape_image_url":{"oneOf":[{"type":"string","description":"URL of the shape image (PNG).","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.shape_image_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"URL of the shape image (PNG).","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.shape_image_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.shape_image_url","typeLabel":"string | null"},"ux_url":{"oneOf":[{"type":"string","description":"URL of the 360 viewer, when media is available.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.ux_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"URL of the 360 viewer, when media is available.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.ux_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.ux_url","typeLabel":"string | null"},"cached_ux_url":{"oneOf":[{"type":"string","description":"Cached 360 viewer URL, when available.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.cached_ux_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Cached 360 viewer URL, when available.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.cached_ux_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.cached_ux_url","typeLabel":"string | null"},"v360_json_base_url":{"oneOf":[{"type":"string","description":"Base URL of the 360 frame assets.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.v360_json_base_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Base URL of the 360 frame assets.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.v360_json_base_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.v360_json_base_url","typeLabel":"string | null"},"v360_info":{"oneOf":[{"type":"object","description":"360 media metadata (`frame_count`, `s3_path`, `md5_hash`, `image_ext`).","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.v360_info.oneOf.0","typeLabel":"object"},{"type":"null","description":"360 media metadata (`frame_count`, `s3_path`, `md5_hash`, `image_ext`).","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.v360_info.oneOf.1","typeLabel":"null"}],"uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.v360_info","typeLabel":"object | null"},"is_sustainable":{"oneOf":[{"type":"boolean","description":"Whether the parcel is flagged as sustainable.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.is_sustainable.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the parcel is flagged as sustainable.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.is_sustainable.oneOf.1","typeLabel":"null"}],"uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.is_sustainable","typeLabel":"boolean | null"},"sustainability_details":{"oneOf":[{"type":"object","description":"Sustainability attributes, when set.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.sustainability_details.oneOf.0","typeLabel":"object"},{"type":"null","description":"Sustainability attributes, when set.","uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.sustainability_details.oneOf.1","typeLabel":"null"}],"uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties.sustainability_details","typeLabel":"object | null"}},"uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties.additionalProperties","typeLabel":"object"},"uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties.additionalProperties","typeLabel":"object"},"uniqueKey":"filters.additionalProperties.additionalProperties.additionalProperties","typeLabel":"object"},"uniqueKey":"filters.additionalProperties.additionalProperties","typeLabel":"object"},"uniqueKey":"filters.additionalProperties","typeLabel":"object"},"uniqueKey":"filters","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"filters":{"round":{"brilliant_cut":{"mined":{"1.3":{"F-D/VS2-VS1":{"id":909651,"sku":"UB-MELEE-1","product_type":"melee","type":"mined","stone_type":null,"quality":"F-D/VS2-VS1","quantity":25,"weight":0.01,"wholesale_price":150,"wholesale_price_per_ct":150,"tolerance_positive":0.05,"tolerance_negative":0.05,"days_to_return":0,"memo_days_to_return":0,"internal_days_to_return":0,"delivery_days_min":1,"delivery_days_max":2,"shape_icon_url":"https://unbridaled-dev.s3.amazonaws.com/das/static/images/shape_icons/shape-round.svg","shape_image_url":"https://unbridaled-dev.s3.amazonaws.com/das/static/images/shape_images/brilliant-round.png","ux_url":"","cached_ux_url":null,"v360_json_base_url":null,"v360_info":null,"is_sustainable":false,"sustainability_details":null}}}}}}},"examples":{"Example":{"title":"Example","value":{"filters":{"round":{"brilliant_cut":{"mined":{"1.3":{"F-D/VS2-VS1":{"id":909651,"sku":"UB-MELEE-1","product_type":"melee","type":"mined","stone_type":null,"quality":"F-D/VS2-VS1","quantity":25,"weight":0.01,"wholesale_price":150,"wholesale_price_per_ct":150,"tolerance_positive":0.05,"tolerance_negative":0.05,"days_to_return":0,"memo_days_to_return":0,"internal_days_to_return":0,"delivery_days_min":1,"delivery_days_max":2,"shape_icon_url":"https://unbridaled-dev.s3.amazonaws.com/das/static/images/shape_icons/shape-round.svg","shape_image_url":"https://unbridaled-dev.s3.amazonaws.com/das/static/images/shape_images/brilliant-round.png","ux_url":"","cached_ux_url":null,"v360_json_base_url":null,"v360_info":null,"is_sustainable":false,"sustainability_details":null}}}}}}}}},"exampleType":"examples"}},"exampleType":"examples"},"9c1a1e4a-979b-4c60-bc7e-de27f3fbe208":{"description":"Missing or invalid token, or API access is not enabled for the merchant.","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string","uniqueKey":"detail","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"detail":"API is not enabled for this merchant."},"examples":{"Example":{"title":"Example","value":{"detail":"API is not enabled for this merchant."}}},"exampleType":"examples"}},"exampleType":"examples"},"2d27f0ed-96ea-41e5-8595-a46601f1dc3c":{"description":"Token type is not allowed on this endpoint.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"548dbed6-ee2a-4ef2-932b-d1b1a2a7a6bf":{"description":"Invalid `shape` or `type` value.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"94968659-f772-404e-8c1e-0c5cced6fb6d":{"apikeyAuth":{"type":"http","scheme":"bearer","scopes":[]}}},"servers":{"39d3dfe0-00de-411f-93fb-df6d227984e7":{"url":"https://api-staging.unbridaled.ai","description":"Sandbox API"},"a9ab9bb5-7ffd-4d53-9f9f-039701667d4d":{"description":"Production API","url":"https://api.unbridaled.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"apikeyAuth","name":"Authorization"}],"title":"apikeyAuth"}]},"originalFileLocation":"openapi/openapi-v3.yml"},"subdomain":"unbridaled","siteName":"Unbridaled Developer Hub","title":"Get Melee Parcel Filters - Unbridaled Developer Hub","navMaps":{"firstHrefInVersion":{"v2":{"href":"/api-reference/v2/diamonds/merchant-search-diamonds","matchLevel":2},"v3":{"href":"/api-reference/v3/diamonds/get-melee-parcel-filters","matchLevel":0}},"firstHrefInLanguage":{}},"lastModified":"2026-08-05T20:37:27.167Z","originalFileLocation":"api-reference/v3/diamonds/get-melee-parcel-filters.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"List the in-stock melee diamond parcels of a given shape and type as a nested filter tree. Only parcels with quantity \u0026gt; 0 are returned. Prices are the merchant\u0026#x27;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 parcel. - size is the stone length for round parcels (e.g. \u0026quot;1.3\u0026quot;) and \u0026quot;{length} x {width}\u0026quot; for every other shape (e.g. \u0026quot;3.5 x 2.75\u0026quot;), in millimeters, formatted to one or two decimals. - quality is \u0026quot;{color_max}-{color}/{clarity_max}-{clarity}\u0026quot; (e.g. \u0026quot;F-D/VS2-VS1\u0026quot;) — the color and clarity range of the stones in the parcel.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Unbridaled Developer Hub\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/unbridaled/Qmey59l3eev3zfik/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/unbridaled/Qmey59l3eev3zfik/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/unbridaled/Qmey59l3eev3zfik/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/unbridaled/Qmey59l3eev3zfik/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/unbridaled/Qmey59l3eev3zfik/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/unbridaled/Qmey59l3eev3zfik/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/unbridaled/Qmey59l3eev3zfik/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/unbridaled/Qmey59l3eev3zfik/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/unbridaled/Qmey59l3eev3zfik/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Melee Parcel Filters - Unbridaled Developer Hub\">\u003cmeta data-mint-head property=\"og:description\" content=\"List the in-stock melee diamond parcels of a given shape and type as a nested filter tree. Only parcels with quantity \u0026gt; 0 are returned. Prices are the merchant\u0026#x27;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 parcel. - size is the stone length for round parcels (e.g. \u0026quot;1.3\u0026quot;) and \u0026quot;{length} x {width}\u0026quot; for every other shape (e.g. \u0026quot;3.5 x 2.75\u0026quot;), in millimeters, formatted to one or two decimals. - quality is \u0026quot;{color_max}-{color}/{clarity_max}-{clarity}\u0026quot; (e.g. \u0026quot;F-D/VS2-VS1\u0026quot;) — the color and clarity range of the stones in the parcel.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Unbridaled Developer Hub\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.unbridaled.ai/api-reference/v3/diamonds/get-melee-parcel-filters\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://unbridaled.mintlify.app/_mintlify/api/og/v2?division=Diamonds\u0026amp;title=Get+Melee+Parcel+Filters\u0026amp;description=List+the+in-stock+melee+diamond+parcels+of+a+given+shape+and+type+as+a+nested+filter+tree.%0A%0AOnly+parcels+with+%60quantity+%3E+0%60+are+returned.+Prices+are+the+mercha\u0026amp;theme=065f12a462b0d0bfb61c33c7\u0026amp;signature=00b9cc4bd1ef949eed72e46a8f8265643c56395d22d4d4da956222495ede69d4\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get Melee Parcel Filters - Unbridaled Developer Hub\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"List the in-stock melee diamond parcels of a given shape and type as a nested filter tree. Only parcels with quantity \u0026gt; 0 are returned. Prices are the merchant\u0026#x27;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 parcel. - size is the stone length for round parcels (e.g. \u0026quot;1.3\u0026quot;) and \u0026quot;{length} x {width}\u0026quot; for every other shape (e.g. \u0026quot;3.5 x 2.75\u0026quot;), in millimeters, formatted to one or two decimals. - quality is \u0026quot;{color_max}-{color}/{clarity_max}-{clarity}\u0026quot; (e.g. \u0026quot;F-D/VS2-VS1\u0026quot;) — the color and clarity range of the stones in the parcel.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://unbridaled.mintlify.app/_mintlify/api/og/v2?division=Diamonds\u0026amp;title=Get+Melee+Parcel+Filters\u0026amp;description=List+the+in-stock+melee+diamond+parcels+of+a+given+shape+and+type+as+a+nested+filter+tree.%0A%0AOnly+parcels+with+%60quantity+%3E+0%60+are+returned.+Prices+are+the+mercha\u0026amp;theme=065f12a462b0d0bfb61c33c7\u0026amp;signature=00b9cc4bd1ef949eed72e46a8f8265643c56395d22d4d4da956222495ede69d4\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/unbridaled/Qmey59l3eev3zfik/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Unbridaled Developer Hub\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#9563FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.unbridaled.ai/api-reference/v3/diamonds/get-melee-parcel-filters\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/v3/diamonds/get-melee-parcel-filters.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.unbridaled.ai/#organization\",\"name\":\"Unbridaled Developer Hub\",\"url\":\"https://developers.unbridaled.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/unbridaled/DSmz57bAj0BM8SXg/logo/light.svg?fit=max\u0026auto=format\u0026n=DSmz57bAj0BM8SXg\u0026q=85\u0026s=d023a18380556ff4aaeccbfd6e1921e2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.unbridaled.ai#website\",\"name\":\"Unbridaled Developer Hub\",\"url\":\"https://developers.unbridaled.ai\",\"publisher\":{\"@id\":\"https://developers.unbridaled.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.unbridaled.ai/api-reference/v3/diamonds/get-melee-parcel-filters#webpage\",\"url\":\"https://developers.unbridaled.ai/api-reference/v3/diamonds/get-melee-parcel-filters\",\"name\":\"Get Melee Parcel Filters\",\"description\":\"List the in-stock melee diamond parcels of a given shape and type as a nested filter tree. Only parcels 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 parcel. - size is the stone length for round parcels (e.g. \\\"1.3\\\") and \\\"{length} x {width}\\\" for every other shape (e.g. \\\"3.5 x 2.75\\\"), in millimeters, formatted to one or two decimals. - quality is \\\"{color_max}-{color}/{clarity_max}-{clarity}\\\" (e.g. \\\"F-D/VS2-VS1\\\") — the color and clarity range of the stones in the parcel.\",\"dateModified\":\"2026-08-05T20:37:27.167Z\",\"isPartOf\":{\"@id\":\"https://developers.unbridaled.ai#website\"},\"breadcrumb\":{\"@id\":\"https://developers.unbridaled.ai/api-reference/v3/diamonds/get-melee-parcel-filters#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.unbridaled.ai/api-reference/v3/diamonds/get-melee-parcel-filters#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Diamonds\",\"item\":\"https://developers.unbridaled.ai/api-reference/v3/diamonds/merchant-search-diamonds\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get Melee Parcel Filters\",\"item\":\"https://developers.unbridaled.ai/api-reference/v3/diamonds/get-melee-parcel-filters\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.unbridaled.ai/api-reference/v3/diamonds/get-melee-parcel-filters#apireference\",\"headline\":\"Get Melee Parcel Filters\",\"name\":\"Get Melee Parcel Filters\",\"description\":\"List the in-stock melee diamond parcels of a given shape and type as a nested filter tree. Only parcels 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 parcel. - size is the stone length for round parcels (e.g. \\\"1.3\\\") and \\\"{length} x {width}\\\" for every other shape (e.g. \\\"3.5 x 2.75\\\"), in millimeters, formatted to one or two decimals. - quality is \\\"{color_max}-{color}/{clarity_max}-{clarity}\\\" (e.g. \\\"F-D/VS2-VS1\\\") — the color and clarity range of the stones in the parcel.\",\"url\":\"https://developers.unbridaled.ai/api-reference/v3/diamonds/get-melee-parcel-filters\",\"mainEntityOfPage\":{\"@id\":\"https://developers.unbridaled.ai/api-reference/v3/diamonds/get-melee-parcel-filters#webpage\"},\"dateModified\":\"2026-08-05T20:37:27.167Z\",\"publisher\":{\"@id\":\"https://developers.unbridaled.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.unbridaled.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Unbridaled Developer Hub\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Unbridaled Developer Hub","nav":{"global":null,"versions":[{"version":"v2","pages":[{"title":"v2","href":"/api-reference/v2/diamonds/merchant-search-diamonds"}]},{"version":"v3","anchors":[{"anchor":"Documentation","icon":"book-open","tabs":[{"tab":"API Reference","groups":[{"group":"Diamonds","pages":[{"openapi":"post /api/v3/diamonds/merchant_search","title":"Merchant Search Diamonds","href":"/api-reference/v3/diamonds/merchant-search-diamonds"},{"openapi":"post /api/v3/diamonds/get_diamonds_by_merchant_templates","title":"Diamonds AI Search","description":"Perform AI search using predefined merchant diamond templates. Each merchant template has a `group` to allow results from different templates from being returned at once. For example, you can create a `group` called `ai_solitaire` with `Standard`, `Premium` and `Ideal` templates if you plan to display the result together.\n\nA `group` in the merchant template can roughly map to a `collection` of products in Shopify or other e-commerce platforms. This allows you to reuse different predefined templates easily for a `group` of products. Refer to `List Merchant Templates` API to learn about Merchant diamonds templates or check our tutorial to learn more about our AI merchant template concept here: [AI Curated Results](https://docs.unbridaled.ai/settings/ai-curated-results).","href":"/api-reference/v3/diamonds/diamonds-ai-search"},{"openapi":"get /api/v3/diamonds/get_parcel_filters","title":"Get Melee Parcel Filters","href":"/api-reference/v3/diamonds/get-melee-parcel-filters"}]},{"group":"Gemstones","pages":[{"openapi":"get /api/v3/gemstones/get_calibrated_filters","title":"Get Calibrated Gemstone Filters","description":"List the in-stock calibrated gemstones of a given shape, stone type, and type as a nested filter tree.\n\nOnly 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.\n\n## Returns\n\nA `filters` object nested five levels deep — `shape` → `cut_code` → `type` → `size` → `quality` — where each leaf is the gemstone.\n\n- `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.\n- `quality` is the calibrated gemstone quality grade — `AAA`, `AA`, `A`, or `B`.","href":"/api-reference/v3/gemstones/get-calibrated-gemstone-filters"}]},{"group":"Inventory","pages":[{"openapi":"get /api/v3/diamonds/{sku}/is_in_stock","title":"Is Diamond In Stock","href":"/api-reference/v3/inventory/is-diamond-in-stock"}]},{"group":"Orders","pages":[{"openapi":"post /api/v3/orders/place","title":"Place Order","href":"/api-reference/v3/orders/place-order"},{"openapi":"get /api/v3/orders/list","title":"List Orders","href":"/api-reference/v3/orders/list-orders"},{"openapi":"get /api/v3/orders/search","title":"Search Orders","href":"/api-reference/v3/orders/search-orders"}]},{"group":"Product Variants","pages":[{"openapi":"post /api/v3/product_variants/watches/query","title":"Query Watch Variants","href":"/api-reference/v3/product-variants/query-watch-variants"},{"openapi":"post /api/v3/product_variants/jewelry/query","title":"Query Jewelry Variants","href":"/api-reference/v3/product-variants/query-jewelry-variants"}]},{"group":"Products","pages":[{"openapi":"post /api/v3/products/query","title":"Query Products","href":"/api-reference/v3/products/query-products"},{"openapi":"post /api/v3/products/jewelry/query","title":"Query Jewelry Products","href":"/api-reference/v3/products/query-jewelry-products"}]},{"group":"Merchant Templates","pages":[{"openapi":"get /api/v3/merchant_templates/list","title":"List Merchant Templates","href":"/api-reference/v3/merchant-templates/list-merchant-templates"}]},{"group":"Merchant Addresses","pages":[{"openapi":"get /api/v3/merchant_addresses/list","title":"List Merchant Addresses","href":"/api-reference/v3/merchant-addresses/list-merchant-addresses"}]},{"group":"Profit Margins","pages":[{"openapi":"get /api/v3/profit_margins/{uuid}","title":"Get Profit Margin","href":"/api-reference/v3/profit-margins/get-profit-margin"},{"openapi":"get /api/v3/profit_margins/list","title":"List Profit Margins","href":"/api-reference/v3/profit-margins/list-profit-margins"}]},{"group":"Defaults","pages":[{"openapi":"get /api/v3/defaults/gem_ratios","title":"Get Default Gem Ratios","href":"/api-reference/v3/defaults/get-default-gem-ratios"},{"openapi":"get /api/v3/defaults/gem_attributes","title":"Get Default Gem Attributes","href":"/api-reference/v3/defaults/get-default-gem-attributes"},{"openapi":"get /api/v3/defaults/profit_margins","title":"Get Default Profit Margins","href":"/api-reference/v3/defaults/get-default-profit-margins"},{"openapi":"get /api/v3/defaults/collections","title":"Get Default Collections","href":"/api-reference/v3/defaults/get-default-collections"},{"openapi":"get /api/v3/defaults/merchant_templates","title":"Get Default Merchant Templates","href":"/api-reference/v3/defaults/get-default-merchant-templates"}]}]}]},{"anchor":"Developer Sandbox","icon":"code","href":"https://app-staging.unbridaled.ai"},{"anchor":"Community","icon":"slack","href":"https://join.slack.com/t/unbridaled/shared_invite/zt-1z8nxnj9e-qRerRZJ0lXknTGcuYKbMjw"}]}]},"title":"Get Melee Parcel Filters - Unbridaled Developer Hub","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-rfhihCWU.js","utils-BmH1XFxk.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BcNsxPKB.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BAES3tkd.js","snippetPresets-DCMQBKLP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D6l_bzE9.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BOktbnNh.js","shallow-BCs8SgM7.js","getApiPlaygroundDisplay-DEmW5bJB.js","CodeSnippet-CpZOpB9C.js","CodeSnippets-BOBDqibl.js","Page-D5fEM6aW.js","getPastedJson-DH2JBvmr.js","icon-BBJH-kKh.js","MethodPill-D2Sd5NLC.js","DuplicateIcon-CGgfL2qN.js","createIcon-BKudBBzi.js","DynamicMarkdown-85clUA0i.js","SectionHeading-D0JiMgDx.js","axios-vUo_bRtp.js","Markdown-Cfiy0xZO.js","clsx-rL8ZCCw4.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-aeztFa9U.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BywkCr5C.js"]}