Melorra Products API

openapi: 3.2.0
info:
  title: Melorra Catalog Products API
  version: 1.0.0
  description: 'Public, unauthenticated read API for Melorra''s gold, silver, diamond and gemstone jewellery catalog. Melorra describes it in its own published API catalog document as the "Public API for Melorra''s product catalog and jewellery services. All endpoints are served from the catalog backend." The surface is read-only (the server advertises `Allow: GET, HEAD, OPTIONS`) and exposes product listings, per-SKU product detail, a richer merchandising detail projection, a silver-line variant of both, and a similar/recommended-products endpoint. All list responses use Django REST Framework PageNumberPagination. Prices are quoted in INR with a set of conversion rates echoed on every response.'
  contact:
    name: Melorra Customer Care
    url: https://www.melorra.com/contactus/
  termsOfService: https://www.melorra.com/privacy-policy/
  x-provider: Melorra (August Jewellery Pvt Ltd)
servers:
- url: https://services-catalog.melorra.com/api
  description: Production catalog backend (named as base_url in Melorra's published api-catalog)
tags:
- name: Products
  description: Gold, diamond and gemstone product listing and detail
paths:
  /product/products/:
    get:
      tags:
      - Products
      operationId: listProducts
      summary: List jewellery products
      description: Lists catalog products with filters, faceting and sorting. Named in Melorra's published api-catalog as "List all jewellery products. Supports multiple filters." Observed count on 2026-08-25 was 21742 products. The response `results` member is an OBJECT (not the array the published catalog document implies) carrying media base paths, a page title, a breadcrumb trail and the `products` array.
      parameters:
      - $ref: '#/components/parameters/Page'
      - name: trend
        in: query
        description: Filter by fashion trend. Documented example value 'Classic' returned count 0 on 2026-08-25.
        schema:
          type: string
      - name: set_name
        in: query
        description: Filter by collection set name, e.g. 'Sea Shell'.
        schema:
          type: string
      - name: wear_type
        in: query
        description: Filter by jewellery type, e.g. 'Bangles', 'Earrings', 'Rings', 'Pendants', 'Necklaces', 'Bracelets'.
        schema:
          type: string
      - name: type
        in: query
        description: Filter by material type, e.g. 'Gold', 'Gemstone'.
        schema:
          type: string
      - name: special_price__range
        in: query
        description: Filter by price range, documented example '10000,20000'. NOTE — the documented example value returned HTTP 500 when probed on 2026-08-25.
        schema:
          type: string
      responses:
        '200':
          description: A page of products
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductListPage'
        '500':
          description: Server error. Observed for the documented special_price__range example value.
  /product/products/{sku}/:
    get:
      tags:
      - Products
      operationId: getProductBySku
      summary: Get a product by SKU
      description: Returns the summary product record for a single SKU, plus the currency and conversion rates. Named in Melorra's published api-catalog as "Get detailed information about a product using its SKU."
      parameters:
      - name: sku
        in: path
        required: true
        description: Product SKU, e.g. 232484.
        schema:
          type: integer
      responses:
        '200':
          description: The product
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductDetailEnvelope'
        '404':
          description: 'Not found — Django REST Framework `{"detail": "Not found."}` envelope.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /product/product/:
    get:
      tags:
      - Products
      operationId: listProductDetails
      summary: List full product detail records
      description: A richer merchandising projection advertised in the API root index. Each result carries media base paths, a breadcrumb trail, full image sets, a pricing block (karat options, ring/bangle sizes, weights, per-size quick-ship and express stock counts) and a product_data block (SEO, collection, shipping lead times and specifications). Observed count on 2026-08-25 was 10000. Unlike listProducts, `results` here is an ARRAY.
      parameters:
      - $ref: '#/components/parameters/Page'
      responses:
        '200':
          description: A page of full product detail records
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductDetailPage'
components:
  schemas:
    ProductListPage:
      allOf:
      - $ref: '#/components/schemas/Pagination'
      - type: object
        properties:
          results:
            type: object
            description: An OBJECT, not an array. Melorra's published api-catalog states the data is "always inside the 'results' field", which holds here, but does not say results is itself an object wrapping a `products` array.
            properties:
              base_image_path:
                type: string
                format: uri
              base_video_path:
                type: string
                format: uri
              title:
                type: string
              breadcrumb:
                $ref: '#/components/schemas/Breadcrumb'
              products:
                type: array
                items:
                  $ref: '#/components/schemas/ProductSummary'
          item_count:
            type: integer
          filters:
            type: object
            description: Faceted filters observed on 2026-08-25 — karat, special_price, gender, weight, wear_type, base_colour, type, nav_menu, try_on, occasion, motif.
            additionalProperties:
              $ref: '#/components/schemas/FilterFacet'
          sorting:
            type: array
            items:
              $ref: '#/components/schemas/SortOption'
          currency:
            $ref: '#/components/schemas/Currency'
          conversion_rates:
            $ref: '#/components/schemas/ConversionRates'
    Error:
      type: object
      description: Django REST Framework error envelope. Not RFC 9457 problem+json.
      properties:
        detail:
          type: string
          examples:
          - Not found.
        currency:
          $ref: '#/components/schemas/Currency'
        conversion_rates:
          $ref: '#/components/schemas/ConversionRates'
    ProductDetail:
      type: object
      description: The rich merchandising projection returned by listProductDetails.
      properties:
        media_base_path:
          type: object
          properties:
            base_image_path:
              type: string
              format: uri
            base_video_path:
              type: string
              format: uri
        breadcrumb:
          $ref: '#/components/schemas/Breadcrumb'
        images:
          $ref: '#/components/schemas/ProductImages'
        pricing:
          $ref: '#/components/schemas/Pricing'
        product_data:
          $ref: '#/components/schemas/ProductData'
    FilterFacet:
      type: object
      description: A faceted filter with its available values and result counts.
      properties:
        count:
          type: integer
        label:
          type: string
        isset:
          type: integer
        values:
          type: array
          items:
            type: object
            properties:
              value:
                type: string
              title:
                type: string
              isset:
                type: integer
              count:
                type: integer
    ShippingData:
      type: object
      description: Published lead times for manufacture, hallmarking and transit.
      properties:
        delivery_date_range:
          type: string
        delivery_date_range_express:
          type: string
        delivery_date_range_qs:
          type: string
        disclaimer_message:
          type: string
        hallmarking_days:
          type:
          - integer
          - string
        lead_time:
          type:
          - integer
          - string
        manufacturing_days:
          type:
          - integer
          - string
        processing_days:
          type:
          - integer
          - string
        transit_days:
          type:
          - integer
          - string
        transit_days_range:
          type: string
    Pagination:
      type: object
      description: Django REST Framework PageNumberPagination envelope.
      properties:
        count:
          type: integer
          description: Total matching records.
        next:
          type:
          - string
          - 'null'
          format: uri
        previous:
          type:
          - string
          - 'null'
          format: uri
    Pricing:
      type: object
      description: Karat and size variant matrix with weights and per-variant stock counts.
      properties:
        status:
          type: boolean
        mumc:
          type: string
        type:
          type: string
        dimension:
          type: string
        diamond_caratage:
          type: string
        product_code:
          type: string
        product_title:
          type: string
        wear_type:
          type: string
        karat:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/KaratOption'
        size:
          type: array
          items:
            $ref: '#/components/schemas/SizeOption'
    Breadcrumb:
      type: array
      items:
        type: object
        properties:
          value:
            type: string
          link:
            type: string
    SizeOption:
      type: object
      properties:
        title:
          type: string
        size:
          type: number
        display_size:
          type: number
        diameter:
          type: string
        circumference:
          type: string
        product_size:
          type: string
        weight_change_percent:
          type: number
        product_code:
          type: string
        quickship_k09_count:
          type: integer
        quickship_k14_count:
          type: integer
        quickship_k18_count:
          type: integer
        quickship_k22_count:
          type: integer
        express_k09_count:
          type: integer
        express_k14_count:
          type: integer
        express_k18_count:
          type: integer
        express_k22_count:
          type: integer
    KaratOption:
      type: object
      properties:
        title:
          type:
          - string
          - 'null'
        weight:
          type:
          - string
          - 'null'
        is_available:
          type: boolean
        product_code:
          type: string
    ConversionRates:
      type: object
      description: Conversion rates from INR, echoed on every response.
      additionalProperties:
        type: number
    ProductDetailPage:
      allOf:
      - $ref: '#/components/schemas/Pagination'
      - type: object
        properties:
          results:
            type: array
            description: An ARRAY here, unlike the object form returned by listProducts.
            items:
              $ref: '#/components/schemas/ProductDetail'
          currency:
            $ref: '#/components/schemas/Currency'
          conversion_rates:
            $ref: '#/components/schemas/ConversionRates'
    ProductSummary:
      type: object
      description: The summary product record returned in listings and by SKU lookup.
      properties:
        sku:
          type: integer
        ext_product_id:
          type: integer
        code:
          type: string
          description: Full variant code including karat and size.
        design_code:
          type: string
        status:
          type: boolean
        trend:
          type: string
        nav_menu:
          type: string
        type:
          type: string
          description: Material type
          e.g. Gold.: null
        product_type:
          type: string
        wear_type:
          type: string
        wear_type_name:
          type: string
        category_name:
          type: string
        set_code:
          type: string
        set_name:
          type: string
        product_title:
          type: string
        productalt_text:
          type: string
        discount_message:
          type: string
        price:
          type: number
        special_price:
          type: number
        quick_ship:
          type: boolean
        express:
          type: boolean
        try_on:
          type: boolean
        new_product:
          type: boolean
        melorraProductUrl:
          type: string
          description: Site-relative product page path.
        images:
          $ref: '#/components/schemas/ProductImages'
        available_in_cluster:
          type: array
          items:
            type: string
    SortOption:
      type: object
      properties:
        key:
          type: string
        value:
          type: string
        isset:
          type: integer
    Currency:
      type: object
      description: Active currency, echoed on every response.
      properties:
        code:
          type: string
          examples:
          - INR
        symbol:
          type: string
    ProductDetailEnvelope:
      allOf:
      - $ref: '#/components/schemas/ProductSummary'
      - type: object
        properties:
          currency:
            $ref: '#/components/schemas/Currency'
          conversion_rates:
            $ref: '#/components/schemas/ConversionRates'
    ProductImages:
      type: object
      description: Image paths, relative to the media base paths returned alongside them.
      properties:
        product_images:
          type: array
          items:
            type: string
        enlarged_images:
          type: array
          items:
            type: string
        category_images:
          type: array
          items:
            type: string
    ProductData:
      type: object
      properties:
        seo:
          type: object
          properties:
            meta_title:
              type: string
            meta_description:
              type: string
        collection:
          type: object
          properties:
            name:
              type: string
            season_name:
              type: string
            trend_name:
              type: string
            collection_link:
              type: string
            banners:
              type: array
              items:
                type: object
                additionalProperties: true
        shipping_data:
          $ref: '#/components/schemas/ShippingData'
        product_specifications:
          type: object
          description: Observed members include sku, product_id, code, design_code, product_title, product_type, type, trend, trend_code, set_name, set_code, category_name, nav_menu, wear_type_name, karat, occasion, enamel_type, discount_message, melorraProductUrl, new_product, try_on, status, productalt_text.
          additionalProperties: true
        additional_product_specifications:
          type: object
          properties:
            preferred_size:
              type:
              - string
              - number
              - 'null'
            quick_ship18k:
              type:
              - boolean
              - integer
              - 'null'
            quick_ship22k:
              type:
              - boolean
              - integer
              - 'null'
            short_description:
              type: string
            wear_type:
              type: string
  parameters:
    Page:
      name: page
      in: query
      description: 1-based page number (Django REST Framework PageNumberPagination).
      schema:
        type: integer
        minimum: 1
x-apievangelist-generated: '2026-08-25'
x-apievangelist-method: generated
x-apievangelist-source: https://www.melorra.com/.well-known/api-catalog (Melorra's own published API catalog document), https://services-catalog.melorra.com/api/product/ (the live Django REST Framework API root index), and live unauthenticated GET responses probed 2026-08-25.
x-apievangelist-note: Melorra publishes a machine-readable API catalog at /.well-known/api-catalog naming a public product API, and the API root at /api/product/ returns a DRF index of endpoints — but Melorra publishes NO OpenAPI of its own. This description is generated faithfully from those two provider-published documents plus live responses observed on 2026-08-25. Every path, method, parameter and field below was either named by Melorra's own catalog/root document or observed in a real response. Schemas are summaries of observed payloads, not an authoritative provider contract. Do not treat this as a Melorra-published artifact.