Get Melee Parcel Filters
curl --request GET \
--url https://api-staging.unbridaled.ai/api/v3/diamonds/get_parcel_filters \
--header 'Authorization: Bearer <token>'import requests
url = "https://api-staging.unbridaled.ai/api/v3/diamonds/get_parcel_filters"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-staging.unbridaled.ai/api/v3/diamonds/get_parcel_filters', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-staging.unbridaled.ai/api/v3/diamonds/get_parcel_filters",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api-staging.unbridaled.ai/api/v3/diamonds/get_parcel_filters"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api-staging.unbridaled.ai/api/v3/diamonds/get_parcel_filters")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-staging.unbridaled.ai/api/v3/diamonds/get_parcel_filters")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"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
}
}
}
}
}
}
}{
"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.
sizeis the stone length forroundparcels (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.qualityis"{color_max}-{color}/{clarity_max}-{clarity}"(e.g."F-D/VS2-VS1") — the color and clarity range of the stones in the parcel.
GET
/
api
/
v3
/
diamonds
/
get_parcel_filters
Get Melee Parcel Filters
curl --request GET \
--url https://api-staging.unbridaled.ai/api/v3/diamonds/get_parcel_filters \
--header 'Authorization: Bearer <token>'import requests
url = "https://api-staging.unbridaled.ai/api/v3/diamonds/get_parcel_filters"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-staging.unbridaled.ai/api/v3/diamonds/get_parcel_filters', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-staging.unbridaled.ai/api/v3/diamonds/get_parcel_filters",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api-staging.unbridaled.ai/api/v3/diamonds/get_parcel_filters"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api-staging.unbridaled.ai/api/v3/diamonds/get_parcel_filters")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-staging.unbridaled.ai/api/v3/diamonds/get_parcel_filters")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"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
}
}
}
}
}
}
}{
"detail": "API is not enabled for this merchant."
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Shape of the melee parcels to list. Defaults to round. See Get Default Gem Attributes for the supported values.
Type of the melee parcels to list. Defaults to mined.
Available options:
mined, lab grown Response
OK
Melee parcels keyed by shape.
Show child attributes
Show child attributes