GIA Report Results API Changelog

2025-06-17

Added

• GIA is excited to announce the Jewelry Report Services. The Jewelry Report and Card Information is available via JewelryGradingReportResults

• For more information, please view the Jewelry Reports & Services Details page.

2024-08-05

Added

• GIA Report QR Code is now accessible via links and assets fields.

2023-11-06

Added

• Custom inscription image is now accessible via links and assets fields of gradingReport.
• The fei_cui_type field is added to IdentificationReportResults.

2023-02-17

Added

• getReportEnc query field
  • This query supports accessing GIA Report Results by using encrypted report number.

2022-12-19

Added

• The Digital Report Access Card is now accessible via links and assets fields.
• The Digital Report Access Card is available for reports delivered after 2022-12-19:
  • Diamond Grading Report (DG)
  • Diamond Dossier Report (DD)
  • Laboratory-Grown Diamond Grading Report (LGDG)
  • Laboratory-Grown Diamond Dossier Report (LGDOSS)

For more information, please view the How to Use the Digital Report Access Card video.

2022-11-15

Added

• AGS Ideal ® Report PDF and ASET image are now accessible via links and assets fields of gradingReport.
• AGS Ideal ® Report results are also available as individual fields. Please refer to SupplementalReportResults for more information.

2022-07-05

Added

• The query getReport now exposes industrydisclosures to provide diamond’s disclosed source of origin.

2021-12-22

Added

• The query getReport now exposes an array of assets linked to a report.

Changed

• Meanings for enum values is available in the Reference Documentation.

2020-12-01

Added

• Colored diamond color grades are now available as individual fields. See CDColorGrade for more information.
• You can now receive updates on any report for 18 months from the time of your original lookup. See Checking for Stale Reports for implementation details.
• Various performance improvements and bug fixes.

Deprecated

• The color field of DiamondData has been deprecated. Use color_grades instead.

2020-08-26

Added

• The enum culet_code provides abbreviations for culet condition

• The enumsgirdle_condition_code and girdle_size_code provide abbreviations for girdle condition and size.

Changed

• A more informative error message is returned when a client queries for a non-Sandbox report using a Sandbox API key.
• The fields shape_code and shape_group_code have been changed from strings to enums. See ShapeCode and ShapeGroupCode.
• The argument report_date on isReportUpdated has been renamed date.

2020-06-08

Added

• isReportUpdated allows you to determine whether a report has been updated after a given date and time. See Checking for Stale Reports for details. Calling isReportUpdated does not incur a quota lookup.
• Quota now returns an array of Quota Buckets. This gives information for each of your lookups purchased, the number of lookups remaining, and the expiration date of the purchase. For more information, please see Quota Monitoring in the API Documentation.
• Tips for migrating from the legacy Report Check API have been added to the API Documentation page. Short codes for culet size, girdle thickness, and girdle condition are listed.

Changed

• The Quickstart Guide is updated to use Insomnia.

2020-02-04

Added

• Volume Pricing is now available in addition to our existing “Pay As You Go” offering. Volume pricing allows clients to lookup reports up to a maximum limit for a set monthly price.
• Diamond Type Letters are now downloadable in PDF form, when requested as part of the grading service.

Changed

• color_distribution added to all synthetic/lab-grown reports
• proportions added to all synthetic/lab-grown reports
• luster, matching, drilling and quantity added to pearl reports

Fixed

• Melee reports now return all fields
• clarity_characteristics now appear on grading reports only

2020-01-24

Changed

• All historical report assets are now available via the API.

2019-11-04

GIA is excited to announce the general availability of the GIA Report Results API!

Added

• getReport query field
• getQuota query field

Note regarding availability of assets: At launch, a limited number of historical reports may not contain assets such as the pdf, plotting and/or proportions diagrams while data migration operations continue. Recently issued reports will contain all expected assets. A note will be posted here once the migration of historical assets is completed.