> ## Documentation Index
> Fetch the complete documentation index at: https://developers.unbridaled.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Query Jewelry Products

> Query the jewelry product catalog with typed jewelry filters
(metal, stone, jewelry type, etc.), price range, and pagination.
Catalog-gated the same way as `products/query`; locked to
`type=jewelry` regardless of request body.

`filter_variant_options` accepts jewelry attribute keys — see
`/api/v3/product_filters?product_type=jewelry` for the current
set of supported keys and their allowed values.



## OpenAPI

````yaml post /api/v3/products/jewelry/query
openapi: 3.1.0
info:
  title: Unbridaled Marketplace Merchant API v3
  description: Developer API to integrate with Unbridaled Marketplace (v3)
  version: 3.0.0
servers:
  - url: https://api-staging.unbridaled.ai
    description: Sandbox API
  - description: Production API
    url: https://api.unbridaled.ai
security:
  - apikeyAuth: []
tags:
  - name: Diamonds
  - name: Inventory
  - name: Orders
  - name: Product Variants
  - name: Products
  - name: Merchant Templates
  - name: Merchant Addresses
  - name: Profit Margins
  - name: Defaults
paths:
  /api/v3/products/jewelry/query:
    post:
      tags:
        - Products
      summary: Query Jewelry Products
      description: |-
        Query the jewelry product catalog with typed jewelry filters
        (metal, stone, jewelry type, etc.), price range, and pagination.
        Catalog-gated the same way as `products/query`; locked to
        `type=jewelry` regardless of request body.

        `filter_variant_options` accepts jewelry attribute keys — see
        `/api/v3/product_filters?product_type=jewelry` for the current
        set of supported keys and their allowed values.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                q:
                  type: string
                id:
                  type: array
                  items:
                    type: string
                  description: Product ID(s) to filter by.
                filter_variant_options:
                  type: object
                  description: >-
                    Jewelry attribute filters, e.g. {"jewelry_type": "Rings"}.
                    See /api/v3/product_filters?product_type=jewelry for
                    supported keys/values.
                wholesale_price_min:
                  type: number
                wholesale_price_max:
                  type: number
                delivery_days_max:
                  type: integer
                order_by:
                  type: string
                  default: updated_on
                  description: >-
                    Column to sort by, or "category" to group by jewelry
                    type/subtype.
                order:
                  type: string
                  enum:
                    - asc
                    - desc
                  default: desc
                limit:
                  type: integer
                  default: 100
                offset:
                  type: integer
                  default: 0
                include_unavailable:
                  type: boolean
                  default: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  products:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        title:
                          type: string
                        description:
                          type: string
                        type:
                          type: string
                        vendor:
                          type: object
                        variants:
                          type: array
                          items:
                            type: object
                  offset:
                    type: integer
                  limit:
                    type: integer
                  total:
                    type: integer
components:
  securitySchemes:
    apikeyAuth:
      type: http
      scheme: bearer

````