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

# List message templates



## OpenAPI

````yaml /openapi.json get /api/v1/templates/
openapi: 3.0.3
info:
  title: ChatBridge Public API
  version: 1.0.0
  description: >-
    Customer-facing REST API for ChatBridge — contacts, conversations, messages,
    templates, team, catalogue, tickets, and WhatsApp Flows. Authenticate with a
    workspace API key: `Authorization: Bearer cb_...`. See
    https://github.com/algosmiths/whatschat/blob/main/public_api.md for the full
    scope/versioning reference.
servers:
  - url: https://api.algosmiths.com
    description: Production
security: []
paths:
  /api/v1/templates/:
    get:
      tags:
        - Templates
      summary: List message templates
      operationId: templates_retrieve
      parameters:
        - in: query
          name: category
          schema:
            type: string
          description: e.g. MARKETING, UTILITY, AUTHENTICATION
        - in: query
          name: status
          schema:
            type: string
          description: e.g. APPROVED, PENDING, REJECTED
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedTemplateList'
          description: ''
      security:
        - ApiKeyAuth: []
        - tokenAuth: []
        - CookieAuth: []
components:
  schemas:
    PaginatedTemplateList:
      type: object
      properties:
        next:
          type: string
          nullable: true
        previous:
          type: string
          nullable: true
        results:
          type: array
          items:
            $ref: '#/components/schemas/Template'
      required:
        - next
        - previous
        - results
    Template:
      type: object
      properties:
        business_account_id:
          type: string
        whatsapp_account_id:
          type: string
        template_id:
          type: string
          maxLength: 255
        name:
          type: string
          maxLength: 512
        components: {}
        language:
          type: string
          maxLength: 8
        status:
          $ref: '#/components/schemas/TemplateStatusEnum'
        category:
          $ref: '#/components/schemas/CategoryEnum'
        quality_score:
          $ref: '#/components/schemas/QualityScoreEnum'
        business_account:
          type: integer
        source_library_template:
          type: integer
          nullable: true
      required:
        - business_account
        - business_account_id
        - category
        - components
        - language
        - name
        - status
        - template_id
        - whatsapp_account_id
    TemplateStatusEnum:
      enum:
        - APPROVED
        - IN_APPEAL
        - PENDING
        - REJECTED
        - PENDING_DELETION
        - DELETED
        - DISABLED
        - PAUSED
        - LIMIT_EXCEEDED
        - ARCHIVED
      type: string
      description: |-
        * `APPROVED` - APPROVED
        * `IN_APPEAL` - IN_APPEAL
        * `PENDING` - PENDING
        * `REJECTED` - REJECTED
        * `PENDING_DELETION` - PENDING_DELETION
        * `DELETED` - DELETED
        * `DISABLED` - DISABLED
        * `PAUSED` - PAUSED
        * `LIMIT_EXCEEDED` - LIMIT_EXCEEDED
        * `ARCHIVED` - ARCHIVED
    CategoryEnum:
      enum:
        - ACCOUNT_UPDATE
        - PAYMENT_UPDATE
        - PERSONAL_FINANCE_UPDATE
        - SHIPPING_UPDATE
        - RESERVATION_UPDATE
        - ISSUE_RESOLUTION
        - APPOINTMENT_UPDATE
        - TRANSPORTATION_UPDATE
        - TICKET_UPDATE
        - ALERT_UPDATE
        - AUTO_REPLY
        - TRANSACTIONAL
        - OTP
        - UTILITY
        - MARKETING
        - AUTHENTICATION
      type: string
      description: |-
        * `ACCOUNT_UPDATE` - ACCOUNT_UPDATE
        * `PAYMENT_UPDATE` - PAYMENT_UPDATE
        * `PERSONAL_FINANCE_UPDATE` - PERSONAL_FINANCE_UPDATE
        * `SHIPPING_UPDATE` - SHIPPING_UPDATE
        * `RESERVATION_UPDATE` - RESERVATION_UPDATE
        * `ISSUE_RESOLUTION` - ISSUE_RESOLUTION
        * `APPOINTMENT_UPDATE` - APPOINTMENT_UPDATE
        * `TRANSPORTATION_UPDATE` - TRANSPORTATION_UPDATE
        * `TICKET_UPDATE` - TICKET_UPDATE
        * `ALERT_UPDATE` - ALERT_UPDATE
        * `AUTO_REPLY` - AUTO_REPLY
        * `TRANSACTIONAL` - TRANSACTIONAL
        * `OTP` - OTP
        * `UTILITY` - UTILITY
        * `MARKETING` - MARKETING
        * `AUTHENTICATION` - AUTHENTICATION
    QualityScoreEnum:
      enum:
        - GREEN
        - YELLOW
        - RED
        - UNKNOWN
        - BLANK
      type: string
      description: |-
        * `GREEN` - GREEN
        * `YELLOW` - YELLOW
        * `RED` - RED
        * `UNKNOWN` - UNKNOWN
        * `BLANK` - BLANK
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: cb_...
      description: >-
        Workspace API key, e.g. `Authorization: Bearer cb_live_...`. Create one
        in Settings → API Keys. See public_api.md § 3 for scopes.
    tokenAuth:
      type: apiKey
      in: header
      name: Authorization
      description: Token-based authentication with required prefix "Token"
    CookieAuth:
      type: apiKey
      in: cookie
      name: token
      description: Dashboard session cookie — internal use only, not the public contract.

````