> ## 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 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. This endpoint is useful for merchants who want to retrieve their available AI-driven search templates and leverage groups to efficiently manage and customize their diamond offerings. 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 list of merchant template objects. ## OpenAPI ````yaml get /api/v2/merchant_templates/list openapi: 3.1.0 info: title: Unbridaled Marketplace Merchant API description: Developer API to integrate with Unbridaled Marketplace version: 1.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: Profit Margins - name: Defaults - name: Merchant Addresses paths: /api/v2/merchant_templates/list: get: tags: - Merchant Templates summary: List Merchant Templates description: > Retrieve a 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. This endpoint is useful for merchants who want to retrieve their available AI-driven search templates and leverage groups to efficiently manage and customize their diamond offerings. 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 list of merchant template objects. parameters: [] responses: '200': description: OK headers: {} content: application/json: schema: type: array items: type: object properties: clarity: type: string color: type: string grade_name: type: string group: type: string label: type: string merchant_uuid: type: - 'null' - string order: type: - 'null' - string position: type: integer uuid: type: string x-examples: Example 1: - clarity: VS1 color: F grade_name: ideal group: DEFAULT label: IDEAL merchant_uuid: null order: null position: 1 uuid: DEFAULT_IDEAL - clarity: VS2 color: H grade_name: excellent group: DEFAULT label: PREMIUM merchant_uuid: null order: null position: 2 uuid: DEFAULT_PREMIUM - clarity: SI1 color: I grade_name: very good group: DEFAULT label: STANDARD merchant_uuid: null order: null position: 3 uuid: DEFAULT_STANDARD - clarity: VVS2 color: G grade_name: very good group: '165444223065' label: NO_LABEL merchant_uuid: 3b12e051-7e22-466e-ac67-483493f17c7d order: none position: 1 uuid: 1d0292f2-2048-45be-8a36-44085fd1ee32 - clarity: VS1 color: G grade_name: ideal group: '165444223065' label: NO_LABEL merchant_uuid: 3b12e051-7e22-466e-ac67-483493f17c7d order: none position: 2 uuid: 38b5c949-69e8-40ab-b731-c86308fe17fe example: - clarity: VS1 color: F grade_name: ideal group: DEFAULT label: IDEAL merchant_uuid: null order: null position: 1 uuid: DEFAULT_IDEAL - clarity: VS2 color: H grade_name: excellent group: DEFAULT label: PREMIUM merchant_uuid: null order: null position: 2 uuid: DEFAULT_PREMIUM - clarity: SI1 color: I grade_name: very good group: DEFAULT label: STANDARD merchant_uuid: null order: null position: 3 uuid: DEFAULT_STANDARD - clarity: VVS2 color: G grade_name: very good group: '165444223065' label: NO_LABEL merchant_uuid: 3b12e051-7e22-466e-ac67-483493f17c7d order: none position: 1 uuid: 1d0292f2-2048-45be-8a36-44085fd1ee32 - clarity: VS1 color: G grade_name: ideal group: '165444223065' label: NO_LABEL merchant_uuid: 3b12e051-7e22-466e-ac67-483493f17c7d order: none position: 2 uuid: 38b5c949-69e8-40ab-b731-c86308fe17fe examples: ListMerchantTemplatesResponse: value: - clarity: VS1 color: F grade_name: ideal group: DEFAULT label: IDEAL merchant_uuid: null order: null position: 1 uuid: DEFAULT_IDEAL - clarity: VS2 color: H grade_name: excellent group: DEFAULT label: PREMIUM merchant_uuid: null order: null position: 2 uuid: DEFAULT_PREMIUM - clarity: SI1 color: I grade_name: very good group: DEFAULT label: STANDARD merchant_uuid: null order: null position: 3 uuid: DEFAULT_STANDARD - clarity: VVS2 color: G grade_name: very good group: '165444223065' label: NO_LABEL merchant_uuid: 3b12e051-7e22-466e-ac67-483493f17c7d order: none position: 1 uuid: 1d0292f2-2048-45be-8a36-44085fd1ee32 - clarity: VS1 color: G grade_name: ideal group: '165444223065' label: NO_LABEL merchant_uuid: 3b12e051-7e22-466e-ac67-483493f17c7d order: none position: 2 uuid: 38b5c949-69e8-40ab-b731-c86308fe17fe components: securitySchemes: apikeyAuth: type: http scheme: bearer ````