curl --request POST \
--url https://api-staging.unbridaled.ai/api/v2/diamonds/merchant_search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"filters": {
"weight_min": 0,
"weight_max": 2,
"type": [
"mined",
"lab grown"
]
},
"limit": 10,
"offset": 0,
"sort_col": "retail_price",
"sort_order": "asc"
}
'{
"filters": {
"cut_code": [
"brilliant_cut",
"modified_cut"
],
"is_fancy": false,
"type": [
"mined",
"lab grown"
]
},
"gems": [
{
"base_currency_code": "USD",
"base_retail_price": 150,
"base_wholesale_price": 100,
"can_hold": true,
"cert_num": "61791373",
"cert_url": "",
"clarity": "SI2",
"clarity_max": null,
"color": "G",
"color_max": null,
"country_code": "IND",
"created_on": "2024-05-15 19:59:50.545918",
"crown_angle": 35.5,
"culet_size": null,
"currency_code": "USD",
"cut_code": "brilliant_cut",
"cut_grade": null,
"cut_grade_description": null,
"days_to_return": 45,
"delivery_days_max": 7,
"delivery_days_min": 5,
"depth": 1.8,
"depth_percentage": 62.5,
"enabled": true,
"exchange_rate": 1,
"eye_clean": "no",
"fancy_color_intensity": null,
"fluorescence": "None",
"girdle_max": null,
"girdle_min": null,
"grow_method": null,
"id": 990157,
"image_bottom_url": null,
"image_top_url": "",
"is_fancy": false,
"is_manual": false,
"is_sustainable": false,
"lab": "GIA",
"length": 2.89,
"media_requested": false,
"memo": false,
"memo_days_to_return": 0,
"merchant_template_group": null,
"merchant_template_label": null,
"merchant_template_position": null,
"merchant_template_uuid": null,
"off_rap_percentage": 54.17823003391919,
"on_hold": false,
"original_imported_ext_url": "",
"overtone": null,
"parcel": false,
"pavilion_angle": 41.6,
"pavilion_depth": 44,
"polish_grade": "EX",
"product_type": "diamond",
"quality": null,
"quantity": 1,
"ratio": 1,
"ratio_group": null,
"retail_price": 150,
"returnable": false,
"shape": "round",
"shape_icon_url": "https://unbridaled-dev.s3.amazonaws.com/das/static/images/shape_icons/shape-round.svg",
"shape_icon_url_png": "https://unbridaled-dev.s3.amazonaws.com/das/static/images/shape_icons/shape-round.png",
"shape_image_url": "https://unbridaled-dev.s3.amazonaws.com/das/static/images/shape_images/brilliant-round.png",
"sku": "UB1DD700DCF7",
"stone_type": null,
"sustainability_details": null,
"symmetry_grade": "VG",
"table_percentage": 60,
"type": "mined",
"updated_on": "2024-05-15 19:59:50.545918",
"ux_url": "",
"v360_info": null,
"v360_json_base_url": "",
"video_url": "",
"weight": 0.094,
"wholesale_price": 100,
"width": 2.88
}
],
"metadata": {
"limit": 50,
"offset": 0,
"total_count": 123934
}
}Search the entire diamonds marketplace using filters.
curl --request POST \
--url https://api-staging.unbridaled.ai/api/v2/diamonds/merchant_search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"filters": {
"weight_min": 0,
"weight_max": 2,
"type": [
"mined",
"lab grown"
]
},
"limit": 10,
"offset": 0,
"sort_col": "retail_price",
"sort_order": "asc"
}
'{
"filters": {
"cut_code": [
"brilliant_cut",
"modified_cut"
],
"is_fancy": false,
"type": [
"mined",
"lab grown"
]
},
"gems": [
{
"base_currency_code": "USD",
"base_retail_price": 150,
"base_wholesale_price": 100,
"can_hold": true,
"cert_num": "61791373",
"cert_url": "",
"clarity": "SI2",
"clarity_max": null,
"color": "G",
"color_max": null,
"country_code": "IND",
"created_on": "2024-05-15 19:59:50.545918",
"crown_angle": 35.5,
"culet_size": null,
"currency_code": "USD",
"cut_code": "brilliant_cut",
"cut_grade": null,
"cut_grade_description": null,
"days_to_return": 45,
"delivery_days_max": 7,
"delivery_days_min": 5,
"depth": 1.8,
"depth_percentage": 62.5,
"enabled": true,
"exchange_rate": 1,
"eye_clean": "no",
"fancy_color_intensity": null,
"fluorescence": "None",
"girdle_max": null,
"girdle_min": null,
"grow_method": null,
"id": 990157,
"image_bottom_url": null,
"image_top_url": "",
"is_fancy": false,
"is_manual": false,
"is_sustainable": false,
"lab": "GIA",
"length": 2.89,
"media_requested": false,
"memo": false,
"memo_days_to_return": 0,
"merchant_template_group": null,
"merchant_template_label": null,
"merchant_template_position": null,
"merchant_template_uuid": null,
"off_rap_percentage": 54.17823003391919,
"on_hold": false,
"original_imported_ext_url": "",
"overtone": null,
"parcel": false,
"pavilion_angle": 41.6,
"pavilion_depth": 44,
"polish_grade": "EX",
"product_type": "diamond",
"quality": null,
"quantity": 1,
"ratio": 1,
"ratio_group": null,
"retail_price": 150,
"returnable": false,
"shape": "round",
"shape_icon_url": "https://unbridaled-dev.s3.amazonaws.com/das/static/images/shape_icons/shape-round.svg",
"shape_icon_url_png": "https://unbridaled-dev.s3.amazonaws.com/das/static/images/shape_icons/shape-round.png",
"shape_image_url": "https://unbridaled-dev.s3.amazonaws.com/das/static/images/shape_images/brilliant-round.png",
"sku": "UB1DD700DCF7",
"stone_type": null,
"sustainability_details": null,
"symmetry_grade": "VG",
"table_percentage": 60,
"type": "mined",
"updated_on": "2024-05-15 19:59:50.545918",
"ux_url": "",
"v360_info": null,
"v360_json_base_url": "",
"video_url": "",
"weight": 0.094,
"wholesale_price": 100,
"width": 2.88
}
],
"metadata": {
"limit": 50,
"offset": 0,
"total_count": 123934
}
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Show child attributes
List of gem skus
List of gem lab
GIA, IGI, GCAL List of gem cert num
List of gem shapes
asscher, baguette, briolette, bullets, calf, cushion, emerald, half_moon, heart, hexagon, lozenge, marquise, octagon, oval, pear, princess, radiant, rectangle, round, shield, tapered_baguette, trapezoid, triangle Whether to only search for gems that can be memoed
Whether to only search for gems that have valid media
Minimum retail price
Maximum retail price
Minimum carat weight
Maximum carat weight
List of gem color values
D, E, F, G, H, I, J, K, L, M, N, O, OP, P, Q, QR, R, S, ST, T, U, UV, V, W, WX, X, Y, YZ, Z List of clarity values
FL, IF, VVS1, VVS2, VS1, VS2, SI1, SI2, I1, I2, I3 List of possible cut grades
IDL, EX, VG, G, F, P, None Polish grades of the gem
EX, VG, G, F, P Fluorescence levels of the gem
Very Strong, Strong, Medium, Faint, Slight, Very Slight, None, Symmetry grades of the gem
EX, VG, G, F, P Minimum depth percentage
Maximum depth percentage
Minimum table percentage
Maximum table percentage
Maximum ratio of length:width
Minimum ratio of length:width
Type of the gem (mined or lab grown)
mined, lab grown Minimum number of delivery days for shipping
Maximum number of delivery days for shipping
List of cut code and shape combo for filtering. This value should be created by joining the cut_code and shape using ':'. For example princess:rose_cut
OK
Show child attributes