The GIA Report Results API allows applications to integrate with GIA’s database in order to verify grading information and retrieve GIA report PDFs, images and other assets associated with a GIA report. This service is available for all reports available on GIA Report Check.
You can use this API for a variety of applications including integrating with internal inventory systems, populating ecommerce sites with report data and displaying PDFs of GIA reports on websites.
API features include:
- Access to report results data including all fields that appear on GIA reports for:
- Natural Diamond Reports
- Colored Natural Diamond Reports
- Colored Stone Reports
- Pearl Reports
- Melee Analysis Results
- Laboratory-Grown Reports
- Narrative Reports
- PDF facsimiles *
- Plotting diagrams *
- Proportions diagrams *
- Digital images *
- Digital videos *
- Fast response time measured in milliseconds
- High availability
- Live uptime and performance status monitoring
- Your usage statistics
How to Apply
Before you can apply for the Report Results API, you must be a current Laboratory Service client. GIA is committed to protecting the integrity of our services and the way we do business and this process ensures we understand who we are doing business with and who we are allowing to access our data.
If you don’t already have an account, learn how to open a Laboratory Service Account.
After your Laboratory Service account has been approved, you can begin the process to apply for API access. During the application process, you will be asked to detail your intended use case and agree to our terms of service.
Once you complete the application, you will immediately receive details for exploring the new API in our sandbox environment which provides access to a limited set of reports that represent the variety of results you can expect from the API. There is no charge for lookups in the sandbox environment.
Once your API application is approved by GIA, you will be able to add a production API plan. API keys associated with this plan can access the full set of reports available in GIA’s database.
For technical details and code examples, please review our developer documentation.
Given the significant value provided by GIA’s investment in this service, we have simple and straightforward pricing plans to meet your needs. There is no charge to build and test your integration with our sandbox environment. When you are ready to retrieve from the full set of grading reports, you can choose between a pay-as-you-go option and a volume pricing option. You can switch plans at any time.
Pay As You Go
To pay as you go, fees are simple and straightforward. You only pay for what you use: US $0.20 (twenty cents U.S.) per report results lookup.
You determine the number of lookups you need in advance and that quota is immediately available for your use. You can purchase more report results lookups at any time. There is no minimum or maximum quota and no long-term contract or commitment.
If you need hundreds of thousands of report lookups a month, you might qualify for one of our volume pricing tiers:
- US $5,000 per month for up to 100,000 lookups
- US $10,000 per month for up to 250,000 lookups
- US $15,000 per month for up to 500,000 lookups
Each calendar month, your quota will automatically reset to the maximum lookup amount in your tier. Unused lookups will not carry over.
* The availability of assets depends upon the type of GIA report. For more information, see GIA report comparisons for natural diamonds, colored natural diamonds, laboratory-grown diamonds, colored stones and pearls.