Catalog

Search available loose lab diamonds

Returns a page of Ada's live loose lab grown diamond inventory, filtered by shape, carat, price, color, clarity, and cut. Stones sell continuously, so treat results as a snapshot and call getDiamond to re-check a specific stone before quoting it. Prices are US dollars for the loose stone only; add a setting from listEngagementRings to quote a finished ring.

get/api/v1/diamonds

Request

  • Base URL: https://www.adadiamonds.com
  • URL: https://www.adadiamonds.com/api/v1/diamonds
  • Auth: one of:
    • none
    • API key in header X-Ada-Api-Key
    • OAuth 2 (authorization code, authorization URL https://www.adadiamonds.com/oauth/authorize, token URL https://www.adadiamonds.com/api/oauth/token; client credentials, token URL https://www.adadiamonds.com/api/oauth/token, scopes: catalog:read)

Query parameters

shapestring

Diamond shape. One of Round, Oval, Cushion, Emerald, Pear, Radiant, Asscher, Princess, Marquise (case-insensitive).

min_caratnumber

Minimum carat weight (inclusive).

max_caratnumber

Maximum carat weight (inclusive).

min_pricenumber

Minimum price in US dollars (inclusive).

max_pricenumber

Maximum price in US dollars (inclusive).

colorstring

Color grade, D through K.

claritystring

Clarity grade: FL, IF, VVS1, VVS2, VS1, VS2, SI1, SI2.

cutstring

Cut grade: Ideal, Excellent, Very Good.

sort'price_asc' | 'price_desc' | 'carat_asc' | 'carat_desc'

Sort order. Default is the feed order.

limitinteger

Results per page (1–200).

offsetinteger

Zero-based offset into the result set.

Response

A page of available diamonds.

object'list' required
currency'USD' required

Example response

{
  "data": [
    {
      "name": "1.02ct F VS1 Ideal Round"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.