# List Templates

URL: https://developers.cuedesk.com/reference/template-management-api/list-templates

`GET https://api.cuedesk.com/v1/templates`

Guide: [Template Management API](https://developers.cuedesk.com/api/template_management_api.md)

Authentication: send `Authorization: Bearer <token>`, with an API token from Settings > API Tokens.

The OpenAPI operation. `$ref` values point into https://developers.cuedesk.com/openapi.json.

```json
{
  "tags": [
    "Templates"
  ],
  "summary": "List Templates",
  "description": "List WhatsApp message templates with optional filtering.",
  "operationId": "list_templates_v1_templates_get",
  "parameters": [
    {
      "name": "limit",
      "in": "query",
      "required": false,
      "schema": {
        "type": "integer",
        "maximum": 100,
        "minimum": 1,
        "default": 50,
        "title": "Limit"
      }
    },
    {
      "name": "offset",
      "in": "query",
      "required": false,
      "schema": {
        "type": "integer",
        "minimum": 0,
        "default": 0,
        "title": "Offset"
      }
    },
    {
      "name": "status",
      "in": "query",
      "required": false,
      "schema": {
        "anyOf": [
          {
            "$ref": "#/components/schemas/TemplateStatus"
          },
          {
            "type": "null"
          }
        ],
        "title": "Status"
      }
    },
    {
      "name": "category",
      "in": "query",
      "required": false,
      "schema": {
        "anyOf": [
          {
            "$ref": "#/components/schemas/TemplateCategory"
          },
          {
            "type": "null"
          }
        ],
        "title": "Category"
      }
    },
    {
      "name": "search",
      "in": "query",
      "required": false,
      "schema": {
        "anyOf": [
          {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          {
            "type": "null"
          }
        ],
        "title": "Search"
      }
    },
    {
      "name": "Authorization",
      "in": "header",
      "required": false,
      "schema": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Authorization"
      },
      "description": "An API token from **Settings > API Tokens**, as `Bearer <token>`.",
      "example": "Bearer <token>"
    }
  ],
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ListTemplatesResponse"
          }
        }
      }
    },
    "4XX": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/TemplateErrorResponse"
          }
        }
      },
      "description": "Client Error"
    },
    "5XX": {
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/TemplateErrorResponse"
          }
        }
      },
      "description": "Server Error"
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "x-cue-guide": {
    "title": "Template Management API",
    "url": "/api/template_management_api"
  }
}
```