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

# List templates

> List document contract templates for a location



## OpenAPI

````yaml /api-reference/documents/openapi.json get /proposals/templates
openapi: 3.0.0
info:
  title: Documents and Contracts API
  description: Documentation for Documents and Contracts API
  version: '1.0'
  contact: {}
servers:
  - url: https://services.leadconnectorhq.com
security: []
tags:
  - name: documents
    description: Documentation for Documents and Contracts API
  - name: contracts
    description: Documentation for Documents and Contracts API
  - name: proposals
    description: Documentation for Documents and Contracts API
paths:
  /proposals/templates:
    get:
      tags:
        - Templates
      summary: List templates
      description: List document contract templates for a location
      operationId: list-documents-contracts-templates
      parameters:
        - name: Authorization
          in: header
          description: Access Token
          required: true
          schema:
            type: string
            example: Bearer 9c48df2694a849b6089f9d0d3513efe
        - name: locationId
          required: true
          in: query
          description: Location Id
          schema:
            example: jhg64gjhb436fv
            type: string
        - name: dateFrom
          required: false
          in: query
          description: Date start from (ISO 8601)
          schema:
            example: '2025-02-03T18:30:00.000Z'
            type: string
        - name: dateTo
          required: false
          in: query
          description: Date to (ISO 8601)
          schema:
            example: '2025-02-14T18:29:59.999Z'
            type: string
        - name: type
          required: false
          in: query
          description: >-
            Comma-separated template types. Valid values: proposal, estimate,
            contentLibrary
          schema:
            example: proposal,estimate
            type: string
        - name: name
          required: false
          in: query
          description: Template Name
          schema:
            example: Template Name
            type: string
        - name: isPublicDocument
          required: false
          in: query
          description: If the docForm is a DocForm
          schema:
            example: false
            type: boolean
        - name: userId
          required: false
          in: query
          description: User Id, required when isPublicDocument is true
          schema:
            example: '1234567890'
            type: string
        - name: limit
          required: false
          in: query
          description: Limit
          schema:
            example: '10'
            type: string
        - name: skip
          required: false
          in: query
          description: Skip
          schema:
            example: '0'
            type: string
        - name: Version
          in: header
          description: API Version
          required: true
          schema:
            type: string
            enum:
              - '2021-07-28'
      responses:
        '200':
          description: Templates fetched successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TemplateListPaginationResponseDTO'
        '400':
          description: Unprocessable Entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestDTO'
      security:
        - bearer: []
        - bearer: []
components:
  schemas:
    TemplateListPaginationResponseDTO:
      type: object
      properties:
        data:
          description: Array of templates
          type: array
          items:
            $ref: '#/components/schemas/TemplateListResponseDTO'
        total:
          type: number
          example: 2
          description: Total number of templates
        traceId:
          type: string
          example: d5656876-86a5-46fb-84df-788f1da7937a
          description: Trace ID for request tracking
      required:
        - data
        - total
    BadRequestDTO:
      type: object
      properties:
        statusCode:
          type: number
          example: 400
        message:
          type: string
          example: Bad Request
    TemplateListResponseDTO:
      type: object
      properties:
        _id:
          type: string
          example: 685d11c371c22e636e9c04b2
          description: Template ID
        deleted:
          type: boolean
          example: false
          description: Whether the template is deleted
        version:
          type: number
          example: 2
          description: Template version
        name:
          type: string
          example: New Template
          description: Template name
        locationId:
          type: string
          example: 5rORm9p7RtxWQPzBIbTG
          description: Location ID
        type:
          type: string
          example: proposal
          description: Template type
          enum:
            - proposal
            - estimate
            - contentLibrary
        updatedBy:
          type: string
          example: K9PSPnWjfNoE8DCf5LJZ
          description: User ID who last updated the template
        isPublicDocument:
          type: boolean
          example: true
          description: Whether the template is a public document
        createdAt:
          type: string
          example: '2025-06-26T09:24:19.305Z'
          description: Template creation date
        updatedAt:
          type: string
          example: '2025-06-26T09:27:32.119Z'
          description: Template last update date
        id:
          type: string
          example: 685d11c371c22e636e9c04b2
          description: Template ID (alias for _id)
        documentCount:
          type: number
          example: 0
          description: Document count (only present when isPublicDocument is true)
        docFormUrl:
          type: string
          example: >-
            https://sendlink.co/documents/doc-form/685d11c371c22e636e9c04b2?locale=en_US
          description: Document form URL (only present when isPublicDocument is true)
      required:
        - _id
        - deleted
        - version
        - name
        - locationId
        - type
        - updatedBy
        - isPublicDocument
        - createdAt
        - updatedAt
        - id
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Access Token or Private Integration Token

````