GIA Report Results API

The secure, dependable way to integrate trusted GIA grading and analysis results into your application or website. Specifically designed for gem and jewelry producers, manufacturers, wholesalers, traders and retailers.

The Problem

You need access to the trusted data that appears on GIA grading and analysis reports in a reliable and secure manner.

Customers today demand that the information they use to inform their purchasing decisions is complete, timely and accurate.

Antiquated methods used to handle data exchanges, like manually entering or uploading spreadsheets, are cumbersome, costly, error-prone processes that can erode trust between your suppliers and customers. You need a service that is easy to integrate into your internal inventory system to populate your e-commerce site with report data or display PDFs of GIA reports on your website.

The Solution

The GIA Report Results API enables you to verify and download results of nearly all GIA grading and analysis reports into your systems in a stable, reliable and speedy manner.

With this service, you can integrate your systems directly with GIA and avoid manually entering or uploading results from non-GIA sources.

The system is engineered for high availability and fast response times, and offers the ability to retrieve report assets including PDFs, images and the rough and polished videos included with the GIA Diamond Origin Report.


Product Features

Comprehensive Data

Retrieve grading and/or analysis results for:

  • Natural diamond reports
  • Colored natural diamond reports
  • Natural diamond origin reports
  • Colored stone reports
  • Pearl reports
  • Melee analysis results
  • Laboratory-grown diamond reports

All fields on the grading reports with full text (e.g., “Excellent”) and abbreviated text are available (e.g., “EX”) as well as proportions, dimensions and more.

High-Quality Report Assets

In each report lookup, you can retrieve individual assets within the results.

PDF Facsimile
Most reports
Proportions Diagram
Most diamond reports

Plotting Diagram
Diamond Grading, Colored Diamond Grading, and Diamond Origin Reports

Digital Image
Colored Diamond and Colored Stone Reports

Rough Image
Diamond Origin Reports
Rough Video
Diamond Origin Reports

Polished Image
Diamond Origin Reports
Polished Video
Diamond Origin Reports

Diamond Type Letter PDF
When requested

The availability of assets depends upon the type of report. For more information, see the comparisons of GIA reports for natural diamonds, colored natural diamonds, laboratory-grown diamonds, colored stones and pearls.

Superior Engineering



GIA recognizes that availability and performance are critical. This service is hosted by redundant data centers across the globe. We’ve built a system to maximize uptime so you always have access to the data you need. You can track our live uptime and performance statistics at

How it Works

Your developers will compose a query, submit it to the API and parse the results, using standard development tools and libraries. We provide complete documentation and example applications in a variety of programming languages to make it easy for your developers to integrate with your systems.

Get Started

  1. Login to your GIA Client Portal

  2. Apply for Report Results API Access (Located under Useful links in your GIA Client Portal)

  3. Build your integration using our sandbox environment immediately at no cost

  4. Purchase report lookups when you are ready to go-live

Getting Started Resources:

Get API Keys


View API Docs


Pricing Options


Build and test your integration with our core set of sample reports. These reports reflect the variety of results you can expect with the API. You can query all data fields and assets in these sample reports from the sandbox.

Pay as you go

When you are ready to retrieve results from the full set of grading reports, we offer a pay-as-you-go option of US $0.20 (twenty cents) per report lookup. This plan is simple and straightforward: you can purchase as many or as few as you need with no monthly commitment. Unused lookups expire on the expiration date specified at the time of purchase.

Volume Pricing*

*Pricing for all monthly plans below are reduced to US $1.00 through December 31, 2020. Learn more here.

GIA offers volume pricing. These plans allow you to lookup reports up to a maximum limit for a set monthly price. Unused lookups do not roll over to the next month.

Plan Name Maximum Lookups per Month Monthly Price Lookups as Low As
Monthly-10k 10,000 US $1,000 / month US $0.10 (50% below pay as you go price)
Monthly-25k 25,000 US $1,750 / month US $0.07 (65% below pay as you go price)
Monthly-50k 50,000 US $3,000 / month US $0.06 (70% below pay as you go price)
Monthly-100k 100,000 US $5,000 / month US $0.05 (75% below pay as you go price)
Monthly-250k 250,000 US $10,000 / month US $0.04 (80% below pay as you go price)
Monthly-500k 500,000 US $15,000 / month US $0.03 (85% below pay as you go price)

Is the GIA Report Results API Right for Me?

This API is ideal for companies that:

  • Require automatic downloads of grading and analysis results into their systems
  • Have access to developers or IT resources