API V2
e1mv3nn4n10kd1lw6mde6sumsPattern: ^[a-z\d]{20,98}$Successful Response
A simplified set of data about a Tracr-registered diamond.
The weight of the diamond in carats
^(?!^[-+.]*$)[+-]?0*\d*\.?\d{0,3}0*$Clarity of the diamond
Colour of the diamond
e1mv3nn4n10kd1lw6mde6sumsPattern: ^[a-z\d]{20,98}$Formatted Fancy colour (Intensity + Overtone + Colour) or colour from the standard scale
The fancy colour of the diamond.
Indicates whether the rough diamond has been verified by Tracr Rough Check
Shape of polished diamond.
Returned when a Diamond is not found in the Tracr network.
Returned when there are issues with the referenced diamond.
Returned when a requested resource has been deleted or expired.
Returned when a Diamond is ineligible for GIS.
Validation Error
Returned when an internal error occurred within GIS.
e1mv3nn4n10kd1lw6mde6sumsPattern: ^[a-z\d]{20,98}$The diamonds carat weight expressed as a decimal.
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$The certificate file. Must be an application/pdf file, otherwise the upload will be rejected.
The clarity of the diamond.
Permitted values:
FL, IF, LC, VVS1, VVS2, VS1, VS2, SI1, SI2, SI3, I1, I2, I3, P1, P2 or P3
The colour of the diamond.
Permitted values:
D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y or Z
The diamonds crown angle expressed as a decimal.
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$The diamonds crown height expressed as a decimal.
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$The culet condition of the diamond.
Permitted values:
P, A or C
The culet size of the diamond.
Permitted values:
EL, VL, L, SL, M, S, VS or N
The cut grade of the diamond.
Permitted values:
I, EX, VG, G, F, P or NA
The diamonds depth expressed as a decimal.
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$The diamonds depth percent expressed as a decimal.
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$The diamonds maximum diameter expressed as a decimal.
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$The diamonds minimum diameter expressed as a decimal.
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$The fancy colour of the diamond.
Permitted values:
BK, B, BN, CH, CM, CG, GY, G, O, P, PL, R, V, Y, W or X
The fancy colour intensity of the diamond.
Permitted values:
F, VL, L, FL, FC, FCD, I, FV or D
The fancy colour overtone of the diamond.
The fluorescence colour of the diamond.
Permitted values:
B, W, Y, O, R, G or N
The fluorescence intensity of the diamond.
Permitted values:
VS, S, M, F, SL, VSL or N
The girdle condition of the diamond.
Permitted values:
P, F or B
The minimum girdle thickness of the diamond.
Permitted values:
Extremely Thick, Very Thick, Thick, Slightly Thick, Medium, Thin, Slightly Thin, Very Thin or Extremely Thin
The maximum girdle thickness of the diamond.
Permitted values:
Extremely Thick, Very Thick, Thick, Slightly Thick, Medium, Thin, Slightly Thin, Very Thin or Extremely Thin
The graded date of the diamond as an ISO 8601 string
The grader certificate number
The grader clarity characteristics.
Free form representation of the diamonds colour.
The grader inscription number
The grader report comments.
The grader report number
Grader report type.
Free form representation of the diamonds shape. This field will be populated on the Diamond Experience Grading page once the information is provided.
Description of the grading certificate.
The grading lab responsible for grading the diamond.
Permitted values:
AGS, CGL, DCLA, GCAL, GHI, GIA, GSI, HRD, IGI, IIDGR, IOD, NGTC, Other, PGS, RDC, RDR, SGL, VGR or SSEF
The diamonds length expressed as a decimal.
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$The measurement text.
The diamonds pavillion angle expressed as a decimal.
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$The diamonds pavillion percent expressed as a decimal.
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$The diamonds polish quality.
Permitted values:
I, EX, VG-EX, VG, G-VG, G, F-G, F or P
The diamonds shape.
Permitted values:
Asscher, Baguette, Briolette, Bullets, Calf, Cushion, Cushion Modified Brilliant, Emerald, European Cut, Flanders, Half Moon, Heart, Hexagonal, Kite, Lozenge, Marquise, Octagonal, Old Miner, Oval, Pear, Pentagonal, Princess, Radiant, Rectangle, Rose, Round, Shield, Square, Square Emerald, Square Radiant, Star, Tapered Baguette, Tapered Bullet, Trapezoid, Triangle, Trilliant or Other
The diamonds symmetry.
Permitted values:
I, EX, VG-EX, VG, G-VG, G, F-G, F or P
The diamonds table percent expressed as a decimal.
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$The diamonds validation level.
Permitted values:
validation or verification
The diamonds width expressed as a decimal.
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$Successful Response
Sent when a graded measurement has been added to a certificate.
The ID of the graded measurement.
The hash of the uploaded file.
Returned when a Diamond is not found in the Tracr network.
Returned when certificate_file is not an application/pdf file.
Returned when a given grading cert. has already been uploaded for a given diamond.
Returned when a requested resource has been deleted or expired.
Returned when a Diamond is ineligible for GIS.
Validation Error
Returned when an internal error occurred within GIS.
e1mv3nn4n10kd1lw6mde6sumsPattern: ^[a-z\d]{20,98}$Successful Response
Sent when a graded measurement has been added to a certificate.
The ID of the graded measurement.
The hash of the uploaded file.
Returned when a Diamond is not found in the Tracr network.
Returned when there are issues with the referenced diamond.
Returned when a requested resource has been deleted or expired.
Returned when a Diamond is ineligible for GIS.
Validation Error
Returned when an internal error occurred within GIS.
e1mv3nn4n10kd1lw6mde6sumsPattern: ^[a-z\d]{20,98}$The data required to add an inscription number to a diamond.
The inscription number to add to the diamond. Must have a non-zero length.
Successful Response
Sent when an inscription number or certificate has been added to a diamond.
The hash of the uploaded inscription number data.
Returned when a Diamond is not found in the Tracr network.
Returned when there are issues with the referenced diamond.
Returned when a given inscription number has already been uploaded for a given diamond.
Returned when a requested resource has been deleted or expired.
Returned when a Diamond is ineligible for GIS.
Validation Error
Returned when an internal error occurred within GIS.
e1mv3nn4n10kd1lw6mde6sumsPattern: ^[a-z\d]{20,98}$Return a QR linking to this diamond in the Diamond Experience.
Returned when a Diamond is not found in the Tracr network.
Returned when the diamond is not polished, or is missing data required by GIS.
Validation Error
Returned when an internal error occurred within GIS.
The success or failure of this operation can be determined by GETing
/v2/diamonds/{diamond_id}/validate/{request_id}.
**Notice:** This endpoint currently only supports validating _round_ diamonds.e1mv3nn4n10kd1lw6mde6sumsPattern: ^[a-z\d]{20,98}$Returned when a validation request is accepted for processing.
A response to a scan-report-based request for the validation of a diamond.
The ID of the diamond for which validation has been requested.
e1mv3nn4n10kd1lw6mde6sumsPattern: ^[a-z\d]{20,98}$The unique ID for this validation request.
e1mv3nn4n10kd1lw6mde6sumsPattern: ^[a-z\d]{20,98}$The URL from which to fetch the status of this validation request via an HTTP GET
The current status of the verification request
PendingReturned when a Diamond is not found in the Tracr network.
Returned when there are issues with the referenced diamond.
Returned when a requested resource has been deleted or expired.
Returned when a Diamond is ineligible for GIS.
Returned when the scan file cannot be parsed or is for an unsupported diamond shape.
Returned when an internal error occurred within GIS.
e1mv3nn4n10kd1lw6mde6sumsPattern: ^[a-z\d]{20,98}$Returned when a validation request is accepted for processing.
A response to a scan-report-based request for the validation of a diamond.
The ID of the diamond for which validation has been requested.
e1mv3nn4n10kd1lw6mde6sumsPattern: ^[a-z\d]{20,98}$The unique ID for this validation request.
e1mv3nn4n10kd1lw6mde6sumsPattern: ^[a-z\d]{20,98}$The URL from which to fetch the status of this validation request via an HTTP GET
The current status of the verification request
PendingReturned when a Diamond is not found in the Tracr network.
Returned when there are issues with the referenced diamond.
Returned when a requested resource has been deleted or expired.
Returned when a Diamond is ineligible for GIS.
Returned when the provided JSON is not valid.
Returned when an internal error occurred within GIS.
e1mv3nn4n10kd1lw6mde6sumsPattern: ^[a-z\d]{20,98}$Successful Response
A ValidationFeedback object used for reporting historic data.
The ID of the diamond for which validation was requested.
e1mv3nn4n10kd1lw6mde6sumsPattern: ^[a-z\d]{20,98}$True if DiamondID did not respond to the request in a timely fashion.
The unique ID of the validation request.
e1mv3nn4n10kd1lw6mde6sumsPattern: ^[a-z\d]{20,98}$The UTC datetime at which the validation request was created.
A message from DiamondID describing the validation status.
The validation status returned by DiamondID.
PendingPossible values: Returned when no validation request has been made for a given diamond.
Validation Error
Returned when an internal error occurred within GIS.
e1mv3nn4n10kd1lw6mde6sumsPattern: ^[a-z\d]{20,98}$e1mv3nn4n10kd1lw6mde6sumsPattern: ^[a-z\d]{20,98}$Successful Response
The full feedback on a V2 validation operation, as returned by GIS.
The ID of the diamond for which validation was requested.
e1mv3nn4n10kd1lw6mde6sumsPattern: ^[a-z\d]{20,98}$The unique ID of the validation request.
e1mv3nn4n10kd1lw6mde6sumsPattern: ^[a-z\d]{20,98}$The UTC datetime at which the validation request was created.
A message detailing the validation status if there were issues.
The validation status for this request.
Validation Error
Returned when an internal error occurred within GIS.
e1mv3nn4n10kd1lw6mde6sumsPattern: ^[a-z\d]{20,98}$Params for a diamond verify request.
^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$An enum of the possible values for the shape_group of a diamond.
This enum is intended to cover different shape groups used by grading labs for verification and validation. For context, grading labs have different shape definitions that may or may not correspond directly to members of the Shape enum.
Note that this enum MUST contain all of the same members as the Shape enum from tracr_core.types.enums, but will contain extras to account for variance across labs.
Successful Response
HTTP response for a diamond verify request.
Potential values for a diamond verification.
Returned when a Diamond is not found in the Tracr network.
Returned when there are issues with the referenced diamond.
Returned when a requested resource has been deleted or expired.
Returned when a Diamond is ineligible for GIS.
Validation Error
Returned when an internal error occurred within GIS.
Last updated