Catalog

Search engagement ring settings

Returns a page of engagement ring settings filtered by the center stone shape they accommodate, style, type, and setting price. priceFrom is the setting alone and excludes the center diamond; pair a result with a stone from listDiamonds and add the two prices to quote a complete ring. Every setting is made to order in platinum or 14k/18k gold.

get/api/v1/engagement-rings

Request

  • Base URL: https://www.adadiamonds.com
  • URL: https://www.adadiamonds.com/api/v1/engagement-rings
  • 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

Center stone shape the setting accommodates.

stylestring

Setting style, e.g. Petite Four Prong, Trellis, Bezel.

typestring

Setting type, e.g. Solitaire, Halo, Three Stone.

min_pricenumber

Minimum price in US dollars (inclusive).

max_pricenumber

Maximum price in US dollars (inclusive).

qstring

Free-text match against the setting name.

limitinteger

Results per page (1–200).

offsetinteger

Zero-based offset into the result set.

Response

A page of settings.

object'list' required
currency'USD' required
price_notestring

Example response

{
  "data": [
    {
      "sku": "AD-066",
      "images": [
        {
          "metal": "white"
        }
      ]
    }
  ]
}

Changes

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