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

# List message templates

> Returns all message templates configured on the WhatsApp Business Account (WABA) associated with this connected account. Templates include approved, pending, rejected, and paused entries. Use the after cursor from paging.cursors to fetch subsequent pages.



## OpenAPI

````yaml /api-reference/openapi.json get /platforms/whatsapp/accounts/{id}/templates
openapi: 3.0.0
info:
  description: >-
    Unified social media inbox API. Read and respond to comments, DMs, reviews,
    and mentions across Instagram, Facebook, Threads, Google Business Profile,
    TikTok, LinkedIn, and YouTube through a single REST API. X/Twitter and
    Trustpilot coming soon.
  title: SocialAPI.AI
  contact:
    name: SocialAPI.AI Support
    email: support@social-api.ai
  license:
    name: MIT
  version: '1.0'
servers:
  - url: https://api.social-api.ai/v1
security: []
paths:
  /platforms/whatsapp/accounts/{id}/templates:
    get:
      tags:
        - WhatsApp
      summary: List message templates
      description: >-
        Returns all message templates configured on the WhatsApp Business
        Account (WABA) associated with this connected account. Templates include
        approved, pending, rejected, and paused entries. Use the after cursor
        from paging.cursors to fetch subsequent pages.
      parameters:
        - example: acc_01HZ9X3Q4R5M6N7P8V2K0W1J
          description: Connected account ID (sapi_acc_...)
          name: id
          in: path
          required: true
          schema:
            type: string
        - example: 25
          description: Maximum number of templates to return (1-100)
          name: limit
          in: query
          schema:
            type: integer
        - description: Pagination cursor (after) from a previous response
          name: cursor
          in: query
          schema:
            type: string
      responses:
        '200':
          description: Templates with pagination cursors
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/api_endpoints.WhatsAppTemplateListResponse
        '401':
          description: Invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api_endpoints.ErrorResponse'
        '404':
          description: Account not found or not owned by caller
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api_endpoints.ErrorResponse'
        '502':
          description: WhatsApp/Meta upstream error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/api_endpoints.ErrorResponse'
      security:
        - BearerAuth: []
components:
  schemas:
    api_endpoints.WhatsAppTemplateListResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/api_endpoints.WhatsAppTemplateInfo'
        paging:
          $ref: '#/components/schemas/api_endpoints.WhatsAppTemplateListPaging'
    api_endpoints.ErrorResponse:
      type: object
      properties:
        error:
          $ref: '#/components/schemas/api_endpoints.ErrorBody'
    api_endpoints.WhatsAppTemplateInfo:
      type: object
      properties:
        category:
          type: string
          enum:
            - AUTHENTICATION
            - MARKETING
            - UTILITY
          example: UTILITY
        components:
          description: Components is the raw WhatsApp template component definition.
        id:
          type: string
          example: '1234567890123456'
        language:
          type: string
          example: en_US
        name:
          type: string
          example: order_confirmation
        status:
          type: string
          enum:
            - APPROVED
            - PENDING
            - REJECTED
            - PAUSED
            - DISABLED
          example: APPROVED
    api_endpoints.WhatsAppTemplateListPaging:
      type: object
      properties:
        cursors:
          $ref: '#/components/schemas/api_endpoints.WhatsAppCursors'
        next:
          type: string
          example: https://graph.facebook.com/...
    api_endpoints.ErrorBody:
      type: object
      properties:
        code:
          type: string
          example: resource.not_found
        message:
          type: string
          example: Account not found
        meta:
          type: object
          additionalProperties: {}
    api_endpoints.WhatsAppCursors:
      type: object
      properties:
        after:
          type: string
          example: QVFIUjN...
        before:
          type: string
          example: QVFIUjJ...
  securitySchemes:
    BearerAuth:
      description: >-
        Prefix your API key with "Bearer ". Example: `Authorization: Bearer
        sapi_key_...`
      type: apiKey
      name: Authorization
      in: header

````