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

# List proposal templates

> Returns the proposal templates shared in the token's team, at any shared level. Private templates are a personal opt-out and are not exposed



## OpenAPI

````yaml get /proposal-templates
openapi: 3.0.4
info:
  title: Vollna API
  description: API for managing Upwork profiles, proposals, results, and filters
  version: 1.0.0
servers:
  - url: https://api.vollna.com/v1
security: []
tags:
  - name: Profiles
    description: Manage Upwork profiles
  - name: Proposals
    description: Access and manage Upwork proposals
  - name: Results
    description: View monitoring results and projects
  - name: Filters
    description: Manage monitoring filters
  - name: Auto Bidding
    description: Manage auto bidding jobs and setups
paths:
  /proposal-templates:
    get:
      tags:
        - Proposal Templates
      summary: List proposal templates
      description: >-
        Returns the proposal templates shared in the token's team, at any shared
        level. Private templates are a personal opt-out and are not exposed
      parameters:
        - name: page
          in: query
          description: Page number
          required: false
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: limit
          in: query
          description: Items per page
          required: false
          schema:
            type: integer
            minimum: 10
            maximum: 100
            default: 20
        - name: sort
          in: query
          description: Sort field
          required: false
          schema:
            type: string
            enum:
              - createdAt
              - updatedAt
              - name
            default: createdAt
        - name: order
          in: query
          description: Sort order
          required: false
          schema:
            type: string
            enum:
              - ASC
              - DESC
            default: DESC
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/ProposalTemplateListItem'
                  pagination:
                    $ref: '#/components/schemas/PaginationTotalPages'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - apiToken: []
components:
  schemas:
    ProposalTemplateListItem:
      type: object
      properties:
        id:
          type: integer
          example: 123
        name:
          type: string
          nullable: true
          example: Web development
        visibility:
          type: string
          enum:
            - shared_view
            - shared_edit
            - shared_admins
          description: Who on the team can see and edit this template
          example: shared_admins
        sender:
          type: object
          description: Who bids with this template
          properties:
            name:
              type: string
              nullable: true
              description: Contractor or freelancer name
              example: John Smith
            type:
              type: string
              enum:
                - agency
                - freelancer
                - manual
              example: agency
            organization:
              type: string
              nullable: true
              description: >-
                Agency name for agency templates, Upwork team name for
                freelancer templates
              example: Acme Agency LLC
        hourly_rate:
          type: object
          properties:
            mode:
              type: string
              enum:
                - fixed
                - smart
                - flexible
              example: smart
            rate:
              type: number
              nullable: true
              description: Base rate; the default rate in flexible mode
              example: 50
            smart_rate_min:
              type: number
              nullable: true
              description: Smart mode only
              example: 25
            smart_rate_max:
              type: number
              nullable: true
              description: Smart mode only
              example: 120
            smart_rate_percent:
              type: integer
              nullable: true
              description: 'Smart mode only: percent of the client''s budget'
              example: 98
            rules_count:
              type: integer
              description: 'Flexible mode: number of budget rules'
              example: 0
            increase_percent:
              type: number
              nullable: true
              description: Scheduled rate increase, percent
              example: null
            increase_frequency:
              type: string
              enum:
                - never
                - every-3-months
                - every-6-months
                - every-12-months
              example: never
        fixed_price:
          type: object
          properties:
            type:
              type: string
              enum:
                - by-job-terms
                - by-project
              example: by-job-terms
            price:
              type: number
              nullable: true
              description: 'by-project only: the same bid on every fixed-price job'
            min_price:
              type: number
              nullable: true
              description: 'by-job-terms only: minimum bid'
            client_budget_percent:
              type: integer
              nullable: true
              description: 'by-job-terms only: bid as a percent of the client''s budget'
        ai:
          type: object
          properties:
            model:
              type: string
              nullable: true
              description: Selected AI model; null means the default model
              example: gemini-3.6-flash
            template_structure:
              type: boolean
              description: Generated proposals follow the template structure
        filters:
          type: array
          description: Filters this template is assigned to
          items:
            type: object
            properties:
              id:
                type: integer
              name:
                type: string
        auto_bidding_setups:
          type: array
          description: Auto-bidding setups that bid with this template
          items:
            type: object
            properties:
              id:
                type: integer
              name:
                type: string
        created_at:
          type: string
          format: date-time
          example: '2026-08-26T10:00:00+00:00'
        updated_at:
          type: string
          format: date-time
          example: '2026-08-26T10:00:00+00:00'
    PaginationTotalPages:
      type: object
      properties:
        total:
          type: integer
          description: Total number of items
          example: 100
        page:
          type: integer
          description: Current page number
          example: 1
        limit:
          type: integer
          description: Number of items per page
          example: 20
        total_pages:
          type: integer
          description: Total number of pages
          example: 5
    Error:
      type: object
      properties:
        error:
          type: string
  securitySchemes:
    apiToken:
      type: apiKey
      name: X-API-TOKEN
      in: header
      description: API token for authentication

````