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

# Get Email Template List

## Endpoint Overview

**GET** `https://api.unibee.dev/merchant/email/template_list`

Get Email Template List

***

## Authorization

All UniBee Merchant API requests require authentication via API key.

| Header          | Required | Description                           |
| --------------- | -------- | ------------------------------------- |
| `Authorization` | Yes      | Bearer `<your_api_key>`               |
| `Content-Type`  | Yes      | `application/json` (for request body) |

***

## Parameters

Path, query, and request body parameters are defined in the schema below. Use the interactive Try it panel to see the full request structure.

Path, query, and request body parameters are defined in the schema below. Use the interactive Try it panel to see the full request structure.

***

## Request examples

### cURL

```bash theme={null}
curl -X GET "https://api.unibee.dev/merchant/email/template_list" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
```

### Sandbox

```bash theme={null}
curl -X GET "https://api-sandbox.unibee.top/merchant/email/template_list" \
  -H "Authorization: Bearer YOUR_SANDBOX_API_KEY" \
  -H "Content-Type: application/json"
```

***

## Response

Success responses return a JSON envelope with `code`, `data`, `message`, `redirect`, and `requestId`. `code` `0` indicates success.

| Field                    | Type    | Description                  |
| ------------------------ | ------- | ---------------------------- |
| `code`                   | integer | Response code. `0` = success |
| `data`                   | object  | Response payload             |
| `data.emailTemplateList` | array   | Email Template Object List   |
| `data.total`             | integer | Total                        |
| `message`                | string  | Human-readable message       |
| `requestId`              | string  | Request ID for support       |

***

## Error handling

| HTTP status | Meaning                                                                   |
| ----------- | ------------------------------------------------------------------------- |
| 400         | Bad request — invalid or missing parameters. Check `message` in the body. |
| 401         | Unauthorized — missing or invalid API key.                                |
| 404         | Not found — invalid path or resource.                                     |
| 500         | Server error — retry with backoff.                                        |

When `code` in the response body is non-zero, check `message` for details. Use `requestId` when contacting support.


## OpenAPI

````yaml get /merchant/email/template_list
openapi: 3.0.0
info:
  description: UniBee Api Server
  license:
    name: Apache-2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  title: OpenAPI UniBee
  version: daily,buildtime:202603161017
servers:
  - url: https://api.unibee.dev
  - url: https://api-sandbox.unibee.top
security:
  - Authorization: []
paths:
  /merchant/email/template_list:
    get:
      tags:
        - Email Template
      summary: Get Email Template List
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  code:
                    format: int
                    properties: {}
                    type: integer
                  data:
                    properties:
                      emailTemplateList:
                        description: Email Template Object List
                        format: '[]*bean.MerchantEmailTemplate'
                        items:
                          $ref: >-
                            #/components/schemas/unibee.api.bean.MerchantEmailTemplate
                        properties: {}
                        type: array
                      total:
                        description: Total
                        format: int
                        properties: {}
                        type: integer
                    type: object
                  merchantId:
                    format: int64
                    properties: {}
                    type: integer
                  message:
                    format: string
                    properties: {}
                    type: string
                  redirect:
                    format: string
                    properties: {}
                    type: string
                  requestId:
                    format: string
                    properties: {}
                    type: string
                type: object
          description: ''
components:
  schemas:
    unibee.api.bean.MerchantEmailTemplate:
      properties:
        VariableGroups:
          format: '[]*bean.TemplateVariableGroup'
          items:
            $ref: '#/components/schemas/unibee.api.bean.TemplateVariableGroup'
          properties: {}
          type: array
        createTime:
          description: create utc time
          format: int64
          properties: {}
          type: integer
        gatewayTemplateId:
          format: string
          properties: {}
          type: string
        id:
          format: int64
          properties: {}
          type: integer
        languageData:
          format: '[]*bean.EmailLocalizationTemplate'
          items:
            $ref: '#/components/schemas/unibee.api.bean.EmailLocalizationTemplate'
          properties: {}
          type: array
        localizationVersions:
          format: '[]*bean.MerchantLocalizationVersion'
          items:
            $ref: '#/components/schemas/unibee.api.bean.MerchantLocalizationVersion'
          properties: {}
          type: array
        merchantId:
          format: int64
          properties: {}
          type: integer
        status:
          format: string
          properties: {}
          type: string
        templateAttachName:
          format: string
          properties: {}
          type: string
        templateContent:
          format: string
          properties: {}
          type: string
        templateDescription:
          format: string
          properties: {}
          type: string
        templateName:
          format: string
          properties: {}
          type: string
        templateTitle:
          format: string
          properties: {}
          type: string
        updateTime:
          description: update utc time
          format: int64
          properties: {}
          type: integer
      type: object
    unibee.api.bean.TemplateVariableGroup:
      properties:
        groupName:
          format: string
          properties: {}
          type: string
        variables:
          format: '[]*bean.TemplateVariable'
          items:
            $ref: '#/components/schemas/unibee.api.bean.TemplateVariable'
          properties: {}
          type: array
      type: object
    unibee.api.bean.EmailLocalizationTemplate:
      properties:
        content:
          format: string
          properties: {}
          type: string
        language:
          format: string
          properties: {}
          type: string
        title:
          format: string
          properties: {}
          type: string
      type: object
    unibee.api.bean.MerchantLocalizationVersion:
      properties:
        activate:
          format: bool
          properties: {}
          type: boolean
        localizations:
          format: '[]*bean.EmailLocalizationTemplate'
          items:
            $ref: '#/components/schemas/unibee.api.bean.EmailLocalizationTemplate'
          properties: {}
          type: array
        versionId:
          format: string
          properties: {}
          type: string
        versionName:
          format: string
          properties: {}
          type: string
      type: object
    unibee.api.bean.TemplateVariable:
      properties:
        variableName:
          format: string
          properties: {}
          type: string
      type: object
  securitySchemes:
    Authorization:
      bearerFormat: JWT
      scheme: bearer
      type: http

````