GIA Report Results API



The most secure, dependable way to integrate trusted GIA grading 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 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.

The antiquated methods used to handle data exchanges today, 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 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 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
  • Identification 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
DG/CDG/DOR/CDOR
Digital Image
Colored diamonds and colored stones

Rough Image
DOR/CDOR
Rough Video
DOR/CDOR
Polished Image
DOR/CDOR
Polished Video
DOR/CDOR

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

Current API Status:

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 https://status.gia.edu.

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 API Keys

 

View API Docs

 

Get Started

First, you will need a GIA laboratory services account. If you don’t already have an account, learn how to open a laboratory service account.

Once that’s taken care of, apply for a GIA Report Results API account. The application form will ask you to describe your use case and accept the API Terms of Service Agreement. There is no charge to apply.

That’s it! You will immediately receive API keys which can access the sandbox environment, allowing you to experiment and test the API. Follow the Quickstart Guide to retrieve your first report results within five minutes.

Pricing Options

Free

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

For retrieving results at scale, GIA offers volume pricing. These plans allow you to lookup reports up to a maximum limit for a set monthly price.

Plan Name Maximum Lookups per Month Monthly Price Lookups as Low As
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 results into their systems
  • Have access to developers or IT resources