> For the complete documentation index, see [llms.txt](https://docs.tracr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tracr.com/tracr-glossary/glossary.md).

# Glossary

<table data-full-width="true"><thead><tr><th>Term</th><th>Definition</th></tr></thead><tbody><tr><td>Ancestor Diamond</td><td><p>Given a diamond, an ancestor of that diamond is either:</p><ul><li>the <strong>parent</strong> diamond,</li><li>the <strong>parent</strong> of the <strong>parent</strong> diamond,</li><li>and so on…</li></ul><p>A diamond’s <strong>ancestors</strong> are all diamonds satisfying this definition.</p></td></tr><tr><td>API</td><td>An Application Programming Interface (API) is a set of functions and procedures that allow two software applications to communicate.</td></tr><tr><td>Application</td><td>Services which interact with the Diamond Traceability Ecosystem through defined interfaces to provide additional functionality. Applications are not part of the Diamond Traceability Ecosystem.</td></tr><tr><td>Blockchain</td><td>A public ledger which records committed transactions on a chain of blocks. The chain constantly grows, with new blocks appended to the chain to represent new transactions. Blockchain technology possesses certain integral key characteristics: decentralisation, persistence, anonymity and auditability.</td></tr><tr><td>Box</td><td>Producers sell diamonds in boxes. A box contains similarly sized rough diamonds.</td></tr><tr><td>Child Diamond</td><td><p>Given a split diamond, a child diamond is either any:</p><ul><li>rough diamond generated by the split operation, or</li><li>rough diamond generated by the split operation that has subsequently been polished.</li></ul><p>A diamond’s <strong>children</strong> are all diamonds satisfying this definition.</p></td></tr><tr><td>Core Service</td><td>A service provided by Tracr’s core Diamond Traceability Ecosystem. For example: Management Portal, DiamondID, and Verification Service.</td></tr><tr><td>Cross Participant Search (XPS)</td><td>An API allowing non-participants to search for diamonds across all of Tracr and return traceability data.</td></tr><tr><td>CSV Template</td><td>A file to help create CSV files containing diamond data in the correct format for upload to Tracr. Templates are available as part of the Integration toolkit for rough, split, and polished diamonds.</td></tr><tr><td>Data</td><td>Content that can provide a description, measurement, or even a report on anything relative to an enterprise’s data assets.</td></tr><tr><td>Data Dictionary</td><td>A spreadsheet which gives a comprehensive overview of all data points required for uploading data for a diamond, at any stage of its lifecycle. The Data Dictionary is part of the Integration toolkit.</td></tr><tr><td>Data Point</td><td>The smallest unit of information about a diamond, used for traceability. It must not contain any personally identifiable information (PII). For example, 4Cs, 3D scan in STL, raw image file, etc.<br>Data points may be classed as Traceability (level 0) data, Supplementary data (Levels 1-3) or Entity Specific data (Level Z).</td></tr><tr><td>Data Quality</td><td>The extent to which a diamond's data points are correct based on surface level checks, and simple heuristics, without any external references.</td></tr><tr><td>DBAS</td><td>De Beers Auction Sales</td></tr><tr><td>Descendant Diamond</td><td><p>Given a diamond, a descendant of that diamond is either:</p><ul><li>a <strong>child</strong> of that diamond,</li><li>a <strong>child</strong> of a <strong>child</strong> of that diamond,</li><li>and so on…</li></ul><p>A diamond’s <strong>descendants</strong> are all diamonds satisfying this definition.</p></td></tr><tr><td>Diamond Ancestry</td><td>The current version of every ancestor diamond of a given diamond, and the diamond itself, ordered by diamond hierarchy.</td></tr><tr><td>Diamond Details page</td><td>A visual representation of a diamond's journey through its lifecycle. It is available for all diamonds in a participant’s inventory. Tracr automatically updates the Diamond Details page if any updates are made to a diamond.</td></tr><tr><td>Diamond History</td><td><p>A collection of data comprising:</p><ul><li>every version of every ancestor of a given diamond, and</li><li>every version of the given diamond itself.</li></ul><p>Order firstly by <strong>diamond hierarchy</strong>, then the version’s <code>system_timestamp</code>.<br>Note that a diamond’s <strong>ancestry</strong> and <strong>versions</strong> are always contained in the diamond’s history.</p></td></tr><tr><td>Diamond ID</td><td>A core service in the Tracr Platform Ecosystem primarily tasked with validating, verifying, and identifying diamonds.<br>Using a combination of data, including images, videos, and reports, it is the way Tracr is able to assure that the diamond being presented to the platform is, in fact, the diamond that the holder is suggesting.</td></tr><tr><td>Diamond Integration Tool (DIT)</td><td>The system which allows participants to add and change data in their instance. By creating a simple data file and uploading it, new records are added to the instance.</td></tr><tr><td>Diamond Lookup</td><td>A tool that can be used by platform participants to view a diamond using a time-limited URL.</td></tr><tr><td>Diamond Record</td><td>A collection of data points associated with a single diamond organised in accordance with the schema.</td></tr><tr><td>Diamond Registry</td><td>A directory that identifies on which platform(s) all or some of the associated diamond record is stored.</td></tr><tr><td>Diamond UID</td><td>The globally unique ID generated by Diamond ID for a single, validated, and verified diamond at a specific time.</td></tr><tr><td>Diamond Version</td><td>A diamond and all its attributes at a given point in time (the <code>system_timestamp</code>).</td></tr><tr><td>Diamond Versions</td><td>All versions of a given diamond, ordered by <code>system_timestamp</code>.</td></tr><tr><td>Diamonds from DTC</td><td>A ‘source of origin claim’ that sightholders and accredited buyers can apply to their sight-sourced diamonds and pass it on with a diamond as it moves down the value chain.<br>All DTC diamonds are sourced in alignment with the OECD’s Due Diligence Guidance, are fully compliant with the Kimberley Process, and originate from Botswana, Canada, Namibia, or South Africa.</td></tr><tr><td>Digital Asset</td><td>Anything that exists in a digital form that comes with a distinct usage right. Digital assets can include any form of digital information—videos, images, animations, and graphics—that is stored in computers, smartphones, digital media, or clouds.<br>For Tracr, each diamond on the platform is represented by a digital asset. All data and accompanying metadata that Tracr possesses on each individual diamond on the platform is amalgamated to produce a digital asset that forms a holistic representation of each diamond registered on the platform.</td></tr><tr><td>Entity-Specific Data</td><td>Participant-specific data to which only that participant has access. This data cannot be shared with other Tracr participants.</td></tr><tr><td>False Match Rate (FMR)</td><td>Used in the context of the Diamond ID service, it represents the ratio of false positive matching results to accurate matches.</td></tr><tr><td>False Non-Match Rate (FNMR)</td><td>Used in the context of the Diamond ID service, it represents the ratio of false negative matching results to accurate matches.</td></tr><tr><td>Diamond Experience</td><td>A search that allows you to retrieve details of any diamond within the Trace network using its Tracr ID.<br>The URL of the search page is https://search.tracr.com/</td></tr><tr><td>Grading Integration Service (GIS)</td><td>A service that allows grading labs to upload a grading certificate and/or inscription number to a diamond record on Tracr.</td></tr><tr><td>Individual Tracr Instance</td><td>Each participant is given their own Tracr instance when onboarded through which they can access the Tracr platform. Each individual instance will only allow a participant access to their own diamonds and not those of other participants.</td></tr><tr><td>Integration Tool</td><td>See Diamond Integration Tool.</td></tr><tr><td>Integration Toolkit</td><td>A collection of scanner templates, CSV templates, and supporting documentation. The Data Dictionary is also part of the Integration toolkit.</td></tr><tr><td>Integration Monitoring</td><td><p>Part of the Tracr Management Portal that displays the verification status of diamonds uploaded to Tracr. Each integration has a status, which can be:</p><ul><li>Registered – The diamond is verified, and on the Tracr Portal.</li><li>Error – An error has occurred, and Tracr did not register the diamond.</li></ul></td></tr><tr><td>Inventory</td><td>Part of the Tracr Management Portal that shows a list of diamonds uploaded to Tracr distributed by lifecycle state.</td></tr><tr><td>Lineage Integrity</td><td>The extent to which the provenance / parentage of a diamond can be verified.</td></tr><tr><td>Locked Diamond</td><td>A polished diamond that has not been unlocked by the participant. The diamond will not appear on the Diamond Experience, Share, Participant API and Participant Search.</td></tr><tr><td>Metadata</td><td>A set of data that describes and gives more information about other data.</td></tr><tr><td>Operation</td><td>A change to a diamond record triggering a blockchain transaction.</td></tr><tr><td>Parent Diamond</td><td>Given a <strong>child</strong> diamond, the parent diamond is the diamond that was split to generate that child. If a parent exists, then it is unique.</td></tr><tr><td>Participant</td><td>A legal entity that interacts with a single instance of the Tracr platform. Participants are DeBeers sightholders who have been onboarded onto the Tracr platform.</td></tr><tr><td>Participant Search (B2B)</td><td>A search that allows you to retrieve details of a participant’s diamond using its Tracr ID. Typically used to retrieve details of one or more diamonds shared with you by a participant.<br>The URL of the search page is https://search.[participant].tracr.com/</td></tr><tr><td>Path</td><td>The route to a data point within a diamond record. For example, the producer’s rough stone authentication scan may be represented by the path: ‘producer/rough/authentication_scan’.</td></tr><tr><td>Platform</td><td>The platform performs operations on behalf of the participant as directed by application(s) or core services.</td></tr><tr><td>Registry</td><td>Central store of authoritative collections: DiamondRegistry, UserRegistry, PlatformRegistry, ApplicationRegistry.</td></tr><tr><td>REST API</td><td>A Representational State Transfer (REST) API is a way for two computer systems to communicate over the Internet using the HTTP technologies. REST defines a set of functions like GET, PUT, and DELETE that a client can use to access data on a server.</td></tr><tr><td>Schema</td><td>The structural definition of the diamond record.</td></tr><tr><td>Shard</td><td>A portion of the diamond record held on a single instance of the platform.</td></tr><tr><td>Share</td><td>Part of the Tracr Management Portal that allows you to share the details of one or more diamonds with an external party. Recipients receive an email containing a link to view the diamond(s) that you shared.</td></tr><tr><td>Shared Instance</td><td>A multi-tenant instance where multiple logins access the same instance but see different content based on their logins.</td></tr><tr><td>Sight</td><td>Sights are sales that take place ten times per year. During the sales period, customers (sightholders and accredited buyers) can inspect the rough diamonds offered to them before deciding what to buy. A sight is identified by the calendar year and the number of that sight within the year.</td></tr><tr><td>Sightholder</td><td>A select group of diamantaires who have demonstrated outstanding business performance and ethical accountability. Each sightholder is selected following a rigorous procedure where the firm in question’s abilities in the core areas of business, strategic planning, manufacturing excellence, business reputation and strict adherence to a code of ethical accountability.</td></tr><tr><td>Supplementary Data</td><td>Data points relating to a diamond in addition to the traceability data. A participant can optionally share supplementary data with other participants.</td></tr><tr><td>Traceability Data</td><td><p>Mandatory data required to use Diamond Traceability Ecosystem. Traceability data constitutes both of:</p><ul><li>Primary data - The data used to trace the diamond along the diamond supply chain through the Diamond Traceability Ecosystem.</li><li>Verification data - The data provided to the Diamond Traceability Ecosystem to permit the performance of diamond identification and verification.</li></ul><p>Ownership of the primary data transfers with the ownership of the associated diamond. A participant can optionally share verification data with other participants.</p></td></tr><tr><td>Tracr</td><td>Tracr is an advanced technology platform developed by De Beers Group to underpin trust in diamond provenance. Using leading-edge technologies, including blockchain, artificial intelligence, the internet of things and advanced security and privacy technologies, Tracr enables confidence in a diamond's source throughout the diamond value chain.</td></tr><tr><td>Tracr ID</td><td>The unique ID allocated when Tracr registers a diamond.</td></tr><tr><td>Tracr Management Portal</td><td>A web-based tool to enable participants to upload, share and transfer their diamonds. The portal provides live feedback to participants on uploads, organises diamonds in a virtual inventory and displays the Diamond Details page.</td></tr><tr><td>Transaction</td><td>An update to a diamond record. This may consist of a single or multiple operations.</td></tr><tr><td>Transfer In</td><td>Receive and accept ownership of a diamond in Tracr transferred from a manufacturer.</td></tr><tr><td>Transfer Out</td><td>Prepare a shipment of diamonds in Tracr for transfer to a retailer.</td></tr><tr><td>Uniqueness</td><td>The extent to which a diamond has not been seen/registered before in the Diamond ID database.</td></tr><tr><td>Unlocked Diamond</td><td>A polished diamond that has been unlocked by a participant. The diamond will appear on the Diamond Experience, Share, Participant API and Participant Search.</td></tr><tr><td>View</td><td>A permissioned subset of data points from a diamond record.</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.tracr.com/tracr-glossary/glossary.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
