Gem

The Gem API returns data on certified stones of a given type.

URIDescription
GET api/v2/gem

Returns the full list of Stuller certified stones. These are unique stones that come with a grading report.

GET api/v2/gem/diamonds

Returns only natural certified diamonds

POST api/v2/gem/diamonds

Returns only natural certified diamonds

GET api/v2/gem/gemstones

Returns only certified gemstones

POST api/v2/gem/gemstones

Returns only certified gemstones

GET api/v2/gem/labgrowndiamonds

Returns only lab-grown certified diamonds

POST api/v2/gem/labgrowndiamonds

Returns only lab-grown certified diamonds

Invoice

The Invoice API is used to retrieve available invoice and tracking infromation for previously placed orders.

URIDescription
GET api/v2/invoice

Returns invoice and tracking information for orders

POST api/v2/invoice

Returns invoice and tracking information for orders

GET api/v2/invoice/shipment?shipmentheaderid={shipmentheaderid}

Returns a list of invoices and their associated details from a given shipment

POST api/v2/invoice/shipment

Returns a list of invoices and their associated details from a given shipment

Orders

The Orders API can be used to retrieve order details for previous orders, and transmit new orders.

URIDescription
GET api/v2/orders

Returns the Order details and status information

POST api/v2/orders

Returns the Order details and status information

POST api/v2/orders/submitorder

Transmit order data to Stuller. Response will indicate a success or failure

Products

The Product API returns all requested data for the requested items. The Product API can also be used to generate a customized item.

URIDescription
GET api/v2/products

Returns specified product data based on specified items. All products and associated data are available if requested.

POST api/v2/products

Returns specified product data based on specified items. All products and associated data are available if requested.

GET api/v2/products/stonefamilies

Used to retrieve available stone families in a mounting's stone location(s).

POST api/v2/products/stonefamilies

Used to retrieve available stone families in a mounting's stone location(s).

GET api/v2/products/searchstones

Allows for the searching of stones by their location(s).

POST api/v2/products/searchstones

Allows for the searching of stones by their location(s).

GET api/v2/products/searchstonesbystonegroup

Allows for the search of available stones by their stone group. A stone group is a group of stones that are similar in size and location on the piece.

POST api/v2/products/searchstonesbystonegroup

Allows for the search of available stones by their stone group. A stone group is a group of stones that are similar in size and location on the piece.

POST api/v2/products/configureproduct

Transmit data indicating how you wish to customize a given item. The response will include updated pricing, imagery, and an estimated ship date based on your customization selections.

GET api/v2/products/advancedproductfilters

Returns available Advanced Product Filter types and values.

POST api/v2/products/advancedproductfilters

Returns available Advanced Product Filter types and values.

GET api/v2/products/relatedadvancedproductfilters

Returns related Advanced Product Filters based on the supplied type.

POST api/v2/products/relatedadvancedproductfilters

Returns related Advanced Product Filters based on the supplied type.

POST api/v2/products/bestfitstonesbydimensions

Returns best fit stones available to set by the requested mounting location dimensions.v

GET api/v2/products/configuredproduct

Returns full details of a customized item by the requested configuration ID.

POST api/v2/products/configuredproduct

Returns full details of a customized item by the requested configuration ID.

GET api/v2/products/virtual

Returns data on "virtual" semi-set inventory for items within the Stuller.com 3C Collection. These items cannot be found directly on Stuller.com and only serve as a different starting point.

POST api/v2/products/virtual

Returns data on "virtual" semi-set inventory for items within the Stuller.com 3C Collection. These items cannot be found directly on Stuller.com and only serve as a different starting point.