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

# List templates

> List WhatsApp templates in your workspace. Cursor-paginated. Only APPROVED templates can be sent.



## OpenAPI

````yaml /openapi.json get /v1/whatsapp/templates
openapi: 3.1.0
info:
  title: Briq API
  description: Karibu Briq API Documentation
  version: '0.8'
servers:
  - url: https://karibu.briq.tz
    description: Production
  - url: https://pre-release.karibu.briq.tz
    description: Pre-release
  - url: http://karibu.briq.tz
    description: LocalPass
security: []
paths:
  /v1/whatsapp/templates:
    get:
      tags:
        - Karibu-Whatsapp-Templates
      summary: List templates
      description: >-
        List WhatsApp templates in your workspace. Cursor-paginated. Only
        APPROVED templates can be sent.
      operationId: wa_list_templates
      parameters:
        - name: sender_id
          in: query
          required: false
          schema:
            type: string
            format: uuid
        - name: status
          in: query
          required: false
          schema:
            type: array
            items:
              type: string
            description: >-
              Filter by one or more admin statuses. Repeat `status` to OR
              values.
        - name: category
          in: query
          required: false
          schema:
            type: array
            items:
              type: string
            description: Filter by one or more categories. Repeat `category` to OR values.
        - name: language
          in: query
          required: false
          schema:
            type: array
            items:
              type: string
            description: >-
              Filter by one or more language codes. Repeat `language` to OR
              values.
        - name: name_or_content
          in: query
          required: false
          schema:
            type: string
            maxLength: 200
            description: Filter by template name or body content.
        - name: cursor
          in: query
          required: false
          schema:
            type: string
            description: Opaque cursor from a previous page's cursor_next.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 50
            minimum: 1
            maximum: 200
        - name: sort
          in: query
          required: false
          schema:
            type: string
            default: updated_desc
      responses:
        '200':
          description: Paginated templates.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WaTemplateListData'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WaErrorEnvelope'
components:
  schemas:
    WaTemplateListData:
      type: object
      description: Cursor-paginated template list.
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/WaTemplateItem'
        cursor_next:
          type: string
          nullable: true
          description: Pass as ?cursor= to fetch the next page; null on the last page.
        total_count:
          type: integer
          nullable: true
    WaErrorEnvelope:
      type: object
      properties:
        success:
          type: boolean
          example: false
        data:
          type: object
          nullable: true
          description: >-
            On a failed send that still produced a record, carries the pollable
            message_id with status='failed'; otherwise null.
        errors:
          type: array
          items:
            $ref: '#/components/schemas/WaApiError'
        request_id:
          type: string
    WaTemplateItem:
      type: object
      description: >-
        An admin-managed WhatsApp template. Only APPROVED templates are
        sendable.
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        language:
          type: string
          nullable: true
        category:
          allOf:
            - $ref: '#/components/schemas/WaTemplateCategory'
          nullable: true
        status:
          $ref: '#/components/schemas/WaTemplateAdminStatus'
        params:
          type: object
          nullable: true
          description: Declared template parameters.
        parameter_format:
          type: string
          nullable: true
          description: NAMED or POSITIONAL.
        template_type:
          allOf:
            - $ref: '#/components/schemas/WaTemplateType'
          nullable: true
        whatsapp_sender_number_id:
          type: string
          format: uuid
          nullable: true
          description: Owning sender.
        provider:
          type: string
          nullable: true
        provider_template_id:
          type: string
          nullable: true
        rejection_reason_text:
          type: string
          nullable: true
        quality_score:
          type: string
          nullable: true
        is_deleted:
          type: boolean
        last_sent_at:
          type: string
          format: date-time
          nullable: true
        approved_at:
          type: string
          format: date-time
          nullable: true
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
    WaApiError:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
        field:
          type: string
          nullable: true
    WaTemplateCategory:
      type: string
      enum:
        - AUTH
        - UTILITY
        - MARKETING
    WaTemplateAdminStatus:
      type: string
      enum:
        - DRAFT
        - IN_REVIEW
        - APPROVED
        - PAUSED
        - REJECTED
        - DISABLED
        - IN_APPEAL
        - PENDING_DELETION
        - DELETED
        - LIMIT_EXCEEDED
        - ARCHIVED
    WaTemplateType:
      type: string
      enum:
        - standard
        - authentication
        - flow
        - limited_time_offer

````