> ## 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.

# List Merchant Templates

> Retrieve a paginated list of merchant templates, including both predefined and default templates. Merchant templates define structured configurations for AI-powered diamond searches, allowing merchants to create curated diamond collections based on specific attributes.

Each template belongs to a `group`, which ensures that diamonds from different templates within the same group can be displayed together in search results. Groups function similarly to collections in e-commerce platforms like Shopify, making it easy to organize and reuse different predefined templates for a consistent shopping experience.

For more details on merchant templates and AI-curated results, refer to the documentation: [AI Curated Results](https://docs.unbridaled.ai/settings/ai-curated-results).

## Returns

A paginated list of merchant template objects with `total`, `offset`, and `limit`.




## OpenAPI

````yaml get /api/v3/merchant_templates/list
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: Merchant Templates
  - name: Merchant Addresses
  - name: Profit Margins
  - name: Defaults
paths:
  /api/v3/merchant_templates/list:
    get:
      tags:
        - Merchant Templates
      summary: List Merchant Templates
      description: >
        Retrieve a paginated list of merchant templates, including both
        predefined and default templates. Merchant templates define structured
        configurations for AI-powered diamond searches, allowing merchants to
        create curated diamond collections based on specific attributes.


        Each template belongs to a `group`, which ensures that diamonds from
        different templates within the same group can be displayed together in
        search results. Groups function similarly to collections in e-commerce
        platforms like Shopify, making it easy to organize and reuse different
        predefined templates for a consistent shopping experience.


        For more details on merchant templates and AI-curated results, refer to
        the documentation: [AI Curated
        Results](https://docs.unbridaled.ai/settings/ai-curated-results).


        ## Returns


        A paginated list of merchant template objects with `total`, `offset`,
        and `limit`.
      parameters:
        - name: offset
          in: query
          description: How many results to skip. Used for pagination. Defaults to 0.
          required: false
          schema:
            type: integer
            default: 0
        - name: limit
          in: query
          description: How many results to return. Defaults to 100.
          required: false
          schema:
            type: integer
            default: 100
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  merchant_templates:
                    type: array
                    items:
                      type: object
                      properties:
                        uuid:
                          type: string
                        merchant_uuid:
                          type:
                            - 'null'
                            - string
                        group:
                          type: string
                        position:
                          type: integer
                        label:
                          type: string
                        color:
                          type: string
                        clarity:
                          type: string
                        grade_name:
                          type: string
                        order:
                          type:
                            - 'null'
                            - string
                  total:
                    type: integer
                  offset:
                    type: integer
                  limit:
                    type: integer
              example:
                merchant_templates:
                  - uuid: DEFAULT_IDEAL
                    merchant_uuid: null
                    group: DEFAULT
                    position: 1
                    label: IDEAL
                    color: F
                    clarity: VS1
                    grade_name: ideal
                    order: null
                  - uuid: DEFAULT_PREMIUM
                    merchant_uuid: null
                    group: DEFAULT
                    position: 2
                    label: PREMIUM
                    color: H
                    clarity: VS2
                    grade_name: excellent
                    order: null
                  - uuid: DEFAULT_STANDARD
                    merchant_uuid: null
                    group: DEFAULT
                    position: 3
                    label: STANDARD
                    color: I
                    clarity: SI1
                    grade_name: very good
                    order: null
                total: 3
                offset: 0
                limit: 100
components:
  securitySchemes:
    apikeyAuth:
      type: http
      scheme: bearer

````