---
title: "Retrieve a collection of templates."
method: GET
path: "/whatsapp/v1/templates"
tags: ["Messages"]
---

# Retrieve a collection of templates.

`GET /whatsapp/v1/templates`

## Request

- Base URL: `https://rest.smsportal.com`
- URL: `https://rest.smsportal.com/whatsapp/v1/templates`
- Auth: HTTP basic

## Query parameters

- `wabaId` string

## Response `200`

Collection of templates for the given Waba.

- ListTemplateResponse
  - `errorCode` string, nullable, required
  - `errorDetail` string, nullable, required
  - `templates` SmsPortalTemplateDto[], nullable, required
    - `id` string, nullable
    - `accountId` string, nullable
    - `wabaId` string, nullable
    - `createdUTC` string, date-time, nullable
    - `action` string, nullable
    - `language` string, nullable
    - `name` string, nullable
    - `status` string, nullable
    - `category` string, nullable
    - `libraryTemplateName` string, nullable
    - `components` WhatsAppComponentDto[], nullable
      - `type` string, nullable
      - `format` string, nullable
      - `add_security_recommendation` boolean, nullable
      - `code_expiration_minutes` integer, nullable
      - `text` string, nullable
      - `buttons` WhatsAppButtonDto[], nullable
        - `type` string, nullable
      - `example` WhatsAppExampleDto
        - `header_text` string[], nullable
        - `body_text` array[], nullable
          - string[]
        - `header_text_named_params` object[], nullable
        - `body_text_named_params` object[], nullable
        - `header_handle` string[], nullable
    - `parameter_format` string, nullable
    - `sub_category` string, nullable
    - `message_send_ttl_seconds` integer
    - `previous_category` string, nullable
    - `template_usable` boolean

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `500`: Something unexpected went wrong, please try again

---

[API](https://skmtc.dev/smsportal/apis/smsportal-whatsapp-api.md) - [All operations](https://skmtc.dev/smsportal/apis/smsportal-whatsapp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smsportal/apis/smsportal-whatsapp-api/revisions/d90371930885?raw)