Get Calibrated Gemstone Filters
curl --request GET \
--url https://api-staging.unbridaled.ai/api/v3/gemstones/get_calibrated_filters \
--header 'Authorization: Bearer <token>'import requests
url = "https://api-staging.unbridaled.ai/api/v3/gemstones/get_calibrated_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/gemstones/get_calibrated_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/gemstones/get_calibrated_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/gemstones/get_calibrated_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/gemstones/get_calibrated_filters")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-staging.unbridaled.ai/api/v3/gemstones/get_calibrated_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": {
"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
}
}
}
}
}
}
}{
"detail": "API is not enabled for this merchant."
}Gemstones
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.
GET
/
api
/
v3
/
gemstones
/
get_calibrated_filters
Get Calibrated Gemstone Filters
curl --request GET \
--url https://api-staging.unbridaled.ai/api/v3/gemstones/get_calibrated_filters \
--header 'Authorization: Bearer <token>'import requests
url = "https://api-staging.unbridaled.ai/api/v3/gemstones/get_calibrated_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/gemstones/get_calibrated_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/gemstones/get_calibrated_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/gemstones/get_calibrated_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/gemstones/get_calibrated_filters")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-staging.unbridaled.ai/api/v3/gemstones/get_calibrated_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": {
"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
}
}
}
}
}
}
}{
"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 calibrated gemstones to list. See Get Default Gem Attributes for the supported values.
Stone type of the calibrated gemstones to list.
Available options:
sapphire, ruby, emerald Type of the calibrated gemstones to list.
Available options:
mined, lab grown Response
OK
Calibrated gemstones keyed by shape.
Show child attributes
Show child attributes