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

# List email templates

> Lists the account's marketing email templates. Passing `page` or `limit` switches to a paginated response: rows exclude the body fields (blocks, styles, html, text), optional `q`/`tags` filters apply across all templates, and the response gains `pagination` and `tag_counts` objects.



## OpenAPI

````yaml /openapi.json get /marketing/templates
openapi: 3.0.0
info:
  title: JetEmail API
  version: 1.0.0
  description: API documentation for JetEmail's transactional email service.
servers:
  - url: https://api.jetemail.com
    description: Production
security:
  - apiKeyAuth: []
tags:
  - name: Email
    description: Send transactional email
  - name: Outbound
    description: 'Outbound sending: keys, SMTP users, domains, logs, suppression'
  - name: Inbound
    description: Inbound routing, domains and forward destinations
  - name: Marketing
    description: >-
      Marketing suite: templates, audiences, contacts, broadcasts, themes,
      assets
externalDocs:
  description: Download OpenAPI Specification
  url: /openapi.json
paths:
  /marketing/templates:
    get:
      tags:
        - Marketing
      summary: List email templates
      description: >-
        Lists the account's marketing email templates. Passing `page` or `limit`
        switches to a paginated response: rows exclude the body fields (blocks,
        styles, html, text), optional `q`/`tags` filters apply across all
        templates, and the response gains `pagination` and `tag_counts` objects.
      parameters:
        - name: page
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            default: 1
          description: Page number (enables pagination)
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 25
          description: Rows per page (enables pagination)
        - name: q
          in: query
          required: false
          schema:
            type: string
          description: Filter by name or subject substring (paginated mode only)
        - name: tags
          in: query
          required: false
          schema:
            type: string
          description: >-
            Comma-separated tags; matches templates having any of them
            (paginated mode only)
      responses:
        '200':
          description: Templates
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  templates:
                    type: array
                    items:
                      $ref: '#/components/schemas/MarketingTemplate'
                  pagination:
                    type: object
                    description: Present in paginated mode
                    properties:
                      page:
                        type: integer
                      limit:
                        type: integer
                      total_count:
                        type: integer
                      has_next_page:
                        type: boolean
                      showing_from:
                        type: integer
                      showing_to:
                        type: integer
                  tag_counts:
                    type: object
                    description: 'Present in paginated mode: account-wide per-tag row counts'
                    additionalProperties:
                      type: integer
components:
  schemas:
    MarketingTemplate:
      type: object
      properties:
        id:
          type: string
          example: 550e8400-e29b-41d4-a716-446655440000
        name:
          type: string
          example: Welcome email
        subject:
          type: string
          example: Welcome to JetEmail 👋
        preview_text:
          type: string
        from_name:
          type: string
          description: Default sender name
        from_email:
          type: string
          description: Default from address — must be on a verified sending domain
        reply_to:
          type: string
          description: Default reply-to
        editor_type:
          type: string
          enum:
            - builder
            - html
          example: builder
        theme_id:
          type: string
          nullable: true
        blocks:
          type: string
          description: JSON array of builder blocks (builder templates render from these)
        styles:
          type: string
          description: JSON EmailStyles (global background/font/colors/button defaults)
        html:
          type: string
          description: Rendered email HTML, merge tokens intact
        text:
          type: string
          description: Plaintext fallback
        created_at:
          type: integer
          description: Unix seconds
        updated_at:
          type: integer
          description: Unix seconds
  securitySchemes:
    apiKeyAuth:
      type: http
      scheme: bearer
      description: API key for account management endpoints. Use your api_ prefixed token.

````