API Documentation and Examples
Stuller’s API (Application Programming Interface) allows your website to connect directly to our inventory, ensuring real-time product availability, pricing, and details. This integration helps streamline operations and enhance your customers’ shopping experience. Be sure to partner with a web developer who has the technical expertise to maximize the benefits of the API.
General Information on Stuller’s APIs
The Stuller API is a collection of REST endpoints that enable a client to interact with Stuller. Given the complexity of some of the requests, each HTTP GET endpoint will also support HTTP POST method. Request and Response structure can be found at https://api.stuller.com/help.
Familiarize yourself with our suite of APIs by reviewing the information below.
NOTE: While our Product and Gem APIs provide real-time product information, we strongly suggest downloading and staging the necessary data to maintain your website's product listings. Our APIs are not built to support the real-time loading of other websites.
Product API
Retrieve all data for any Stuller product(s) including real-time pricing and availability information.
Product Configuration API
The configuration section of the Stuller Product API is a set of REST endpoints used to receive data on Stuller configurations.
Virtual Product API
The Stuller Virtual Product API is a REST endpoint used to receive data on Stuller’s virtual products. Virtual products are semi-set jewelry products created exclusively for the API with the intent to alleviate challenges with pricing and media.
Gem API
Retrieve data for all active diamonds with reports and Notable Gems® (a unique, hand-selected collection of gemstones). Stuller carries unique diamonds and gemstones, which are broken out into three different categories: large natural diamonds with reports, large lab-grown diamonds with reports, and Notable Gems.
Order API
The Order API allows you to transmit orders to Stuller and check the status of previous orders. This is ideal to use in conjunction with Stuller's Pack and Ship dropshipping services.
Invoice API
The Invoice API is used to retrieve available invoice and tracking information for previously placed orders.