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

# List Templates

> Use this endpoint to list all templates available in the system. You can apply filters, pagination, and sorting to narrow down results and find specific templates based on your criteria.



## OpenAPI

````yaml /en/openapi/v3-current/reporter.yaml get /v1/templates
openapi: 3.1.0
info:
  title: Reporter
  description: ''
  version: 1.2.0
servers:
  - url: https://reporter.sandbox.lerian.net
security: []
tags: []
paths:
  /v1/templates:
    get:
      tags:
        - Templates API
      summary: List Templates
      description: >-
        Use this endpoint to list all templates available in the system. You can
        apply filters, pagination, and sorting to narrow down results and find
        specific templates based on your criteria.
      parameters:
        - $ref: '#/components/parameters/Authorization'
        - $ref: '#/components/parameters/XOrganizationId'
        - name: page
          in: query
          description: The number of the page that you want to retrieve.
          required: false
          schema:
            type: integer
        - name: limit
          in: query
          description: Maximum number of items returned per page.
          required: false
          schema:
            type: integer
        - name: outputFormat
          in: query
          description: The format of the generated output.
          required: false
          schema:
            type: string
            enum:
              - HTML
              - CSV
              - PDF
              - TXT
              - XML
        - name: description
          in: query
          description: Briefly describes what the template is for or what it contains.
          required: false
          schema:
            type: string
        - name: createdAt
          in: query
          description: Timestamp indicating when the template was created.
          required: false
          schema:
            type: string
      responses:
        '200':
          description: The list of all templates available in the system.
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/Template'
              example:
                items:
                  - id: 0196b193-0dc6-7a30-abb5-4f1ce5e8f829
                    outputFormat: HTML
                    description: Statements
                    fileName: 0196b193-0dc6-7a30-abb5-4f1ce5e8f829.tpl
                    createdAt: '2025-05-08T20:25:26.726Z'
                    updatedAt: '2025-05-08T20:25:26.726Z'
                    deletedAt: null
                  - id: 0196b1a4-a154-7adc-81c2-45fb1393c30d
                    outputFormat: TXT
                    description: CNAB
                    fileName: 0196b1a4-a154-7adc-81c2-45fb1393c30d.tpl
                    createdAt: '2025-05-08T20:44:38.612Z'
                    updatedAt: '2025-05-08T20:44:38.612Z'
                    deletedAt: null
                page: 1
                limit: 10
                total: 6
          headers: {}
        '400':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                Error0004:
                  $ref: '#/components/examples/Error0004'
                Error0015:
                  $ref: '#/components/examples/Error0015'
                Error0016:
                  $ref: '#/components/examples/Error0016'
                Error0017:
                  $ref: '#/components/examples/Error0017'
                Error0018:
                  $ref: '#/components/examples/Error0018'
                Error0019:
                  $ref: '#/components/examples/Error0019'
                Error0020:
                  $ref: '#/components/examples/Error0020'
                Error0021:
                  $ref: '#/components/examples/Error0021'
                Error0022:
                  $ref: '#/components/examples/Error0022'
                Error0023:
                  $ref: '#/components/examples/Error0023'
                Error0024:
                  $ref: '#/components/examples/Error0024'
                Error0025:
                  $ref: '#/components/examples/Error0025'
      security: []
components:
  parameters:
    Authorization:
      name: Authorization
      in: header
      description: >-
        The authorization token in the 'Bearer <token>' format.  


        **Important:** This header is required if your environment has Access
        Manager enabled. For more information, refer to the [Access
        Manager](/en/access-manager) documentation.
      required: false
      schema:
        type: string
    XOrganizationId:
      name: X-Organization-id
      in: header
      description: The unique identifier of the Organization associated with the request.
      required: true
      example: 019c96a0-0a98-7287-9a31-786e0809c769
      schema:
        type: string
  schemas:
    Template:
      type: object
      properties:
        id:
          type: string
          description: Unique ID that identifies the template (UUID format).
        outputFormat:
          type: string
          description: The format of the generated output (e.g., HTML, CSV, PDF, TXT, XML).
        description:
          type: string
          description: Briefly describes what the template is for or what it contains.
        fileName:
          type: string
          description: >-
            The name of the template file as stored in the system. Follows the
            `<template_id>.tpl` format.
        createdAt:
          type: string
          description: Timestamp indicating when the template was created.
        updatedAt:
          type: string
          description: Timestamp indicating the last time the template was updated.
        deletedAt:
          type: string
          description: Timestamp indicating when the template was soft deleted.
    Error:
      type: object
      properties:
        code:
          type: string
          description: A unique, stable identifier for the error.
        title:
          type: string
          description: A brief summary of the issue.
        message:
          type: string
          description: Detailed guidance for resolving the error.
      description: Response message error.
      required:
        - code
        - title
        - message
  examples:
    Error0004:
      summary: Invalid header
      value:
        code: TPL-0004
        title: Invalid header
        message: >-
          One or more header values are missing or incorrectly formatted. Please
          verify required headers %VALUE.
    Error0015:
      summary: Unexpected Fields in the Request
      value:
        code: TPL-0015
        title: Unexpected Fields in the Request
        message: >-
          The request body contains more fields than expected. Please send only
          the allowed fields as per the documentation. The unexpected fields are
          listed in the fields object.
    Error0016:
      summary: Missing Fields in Request
      value:
        code: TPL-0016
        title: Missing Fields in Request
        message: >-
          Your request is missing one or more required fields. Please refer to
          the documentation to ensure all necessary fields are included in your
          request.
    Error0017:
      summary: Bad Request
      value:
        code: TPL-0017
        title: Bad Request
        message: >-
          The server could not understand the request due to malformed syntax.
          Please check the listed fields and try again.
    Error0018:
      summary: Internal Server Error
      value:
        code: TPL-0018
        title: Internal Server Error
        message: >-
          The server encountered an unexpected error. Please try again later or
          contact support.
    Error0019:
      summary: Invalid Query Parameter
      value:
        code: TPL-0019
        title: Invalid Query Parameter
        message: >-
          One or more query parameters are in an incorrect format. Please check
          the following parameters '%v' and ensure they meet the required format
          before trying again.
    Error0020:
      summary: Invalid Date Format Error
      value:
        code: TPL-0020
        title: Invalid Date Format Error
        message: >-
          The 'initialDate', 'finalDate', or both are in the incorrect format.
          Please use the 'yyyy-mm-dd' format and try again.
    Error0021:
      summary: Invalid Final Date Error
      value:
        code: TPL-0021
        title: Invalid Final Date Error
        message: >-
          The 'finalDate' cannot be earlier than the 'initialDate'. Please
          verify the dates and try again.
    Error0022:
      summary: Date Range Exceeds Limit Error
      value:
        code: TPL-0022
        title: Date Range Exceeds Limit Error
        message: >-
          The range between 'initialDate' and 'finalDate' exceeds the permitted
          limit of %v months. Please adjust the dates and try again.
    Error0023:
      summary: Invalid Date Range Error
      value:
        code: TPL-0023
        title: Invalid Date Range Error
        message: >-
          Both 'initialDate' and 'finalDate' fields are required and must be in
          the 'yyyy-mm-dd' format. Please provide valid dates and try again.
    Error0024:
      summary: Pagination Limit Exceeded
      value:
        code: TPL-0024
        title: Pagination Limit Exceeded
        message: >-
          The pagination limit exceeds the maximum allowed of %v items per page.
          Please verify the limit and try again.
    Error0025:
      summary: Invalid Sort Order
      value:
        code: TPL-0025
        title: Invalid Sort Order
        message: >-
          The 'sort_order' field must be 'asc' or 'desc'. Please provide a valid
          sort order and try again.

````