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

Report Results API 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

Report Results API 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 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.

Report Image PDF Facsimile
Most reports
Proportions Diagram
Proportions Diagram
Most diamond reports
Clarity Diagram
Plotting Diagram
Diamond Grading, Colored Diamond Grading, and Diamond Origin Reports
Digital Image
Digital Image
Colored diamonds and colored stones
Rough Diamond
Rough Image
Diamond Origin Reports
Rough Video
Diamond Origin Reports
Polished Diamond
Polished Image
Diamond Origin Reports
Polished Video
Diamond Origin Reports
Diamond Type Letter
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


Current API Status:

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

  4. Access your own reports for no charge or purchase lookups to access results from GIA's full set of reports.

Getting Started Resources:

Get API Keys


View API Docs


Pricing Options

Free Plan

  • Unlimited lookups on your direct GIA submissions

  • Develop your integration with GIA’s sandbox reports

  • No credit card necessary

Paid Plans

Option 1: Pay As You Go

  • US $0.20 (twenty cents) per report lookup

  • Unused lookups expire six months after purchase

  • Best value for fewer than 5,000 report lookups per month

Option 2: Monthly Subscription

  • Up to 85% discount off of pay as you go plans

  • Automatic renewal, cancel anytime

  • Unused lookups do not roll over to the next month

  • Receive twelve (12) months for the price of ten (10) with annual billing


Maximum Lookups per Month Paid Monthly Paid Annually Lookups as Low As
Purchase pay as you go lookups
Purchase pay as you go lookups
US $0.20
US $1,000 / month
US $10,000
US $0.10 (50% below pay as you go price)
Annual billing saves an additional US $2,000
US $1,750 / month
US $17,500
US $0.07 (65% below pay as you go price)
Annual billing saves an additional US $3,500
US $3,000 / month
US $30,000
US $0.06 (70% below pay as you go price)
Annual billing saves an additional US $6,000
US $5,000 / month
US $50,000
US $0.05 (75% below pay as you go price)
Annual billing saves an additional US $10,000
US $10,000 / month
US $100,000
US $0.04 (80% below pay as you go price)
Annual billing saves an additional US $20,000
US $15,000 / month
US $150,000
US $0.03 (85% below pay as you go price)
Annual billing saves an additional US $30,000

Get the most flexibility by combing plans to match your usage patterns. For example, if you require 12,000 lookups per month, purchase the 10,000 monthly plan and 2,000 pay as you go lookups. Your total cost will be lower than the cost of the next subscription tier.

To pay annually, please contact us.

Additional Benefits

  • Paid lookups entitle you to retrieve the same report any number of times within 18 months from the initial lookup
  • Automatic subscription allows you to receive updates to reports you retrieved in the last 18 months

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