> For the complete documentation index, see [llms.txt](https://docs-latam.messaging.sinch.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-latam.messaging.sinch.com/technical-documentation/api-and-integrations/listing-message-templates.md). # Listing Message Templates Request **The request can contain the following parameters in the query string** | Field | Required | Description | | ------------- | -------- | ------------------------------------------------------------------- | | page | no | Page index beginning at 1 | | page\_size | no | Page results. 10 by default | | element\_name | no | Search for templates containing element\_name as part of their name | ## Response Example ``` { "data" : [ { "message_type" : "RESERVATION_UPDATE", "customer_id" : 6364, "messages" : [ { "buttons_type" : null, "id" : 33732, "buttons" : { "payload" : null }, "language" : "EN", "last_modified" : "2020-06-04T14:52:39.674403", "placeholders" : ["data"], "header" : "", "text" : "Hello, you have an appointment with us for *{{1}}*.\nReply *YES* to confirm or *NO* to cancel.", "header_type" : "none", "status" : "approved", "footer" : "" } ], "sub_account_id" : 11486, "last_modified" : "2020-06-04T14:52:39.665449", "id" : 22045, "element_name" : "appointment_reminder_datetime", "namespace" : "whatsapp:hsm:ecommerce:movile", "template_type" : "header_footer", "languages" : ["EN"] }, { "messages" : [ { "status" : "approved", "footer" : "", "text" : "You have an appointment with us!", "header_type" : "none", "header" : "", "language" : "EN", "placeholders" : [], "last_modified" : "2020-06-02T18:46:01.386517", "buttons" : { "payload" : null }, "id" : 33649, "buttons_type" : null } ], "sub_account_id" : 11486, "customer_id" : 6364, "message_type" : "RESERVATION_UPDATE", "template_type" : "header_footer", "languages" : ["EN"], "namespace" : "whatsapp:hsm:ecommerce:movile", "id" : 21964, "element_name" : "appointment_reminder", "last_modified" : "2020-06-02T18:46:01.384862" } ] } ​ ``` The response returns a list of message templates with the following fields | Field | Details | Tipo | | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | | languages | Languages this template is available in | \[String] | | namespace | Template namespace. Must be used in the messaging API | String | | element\_name | Template name. Must be used in the messaging API | String | | message\_type |

Template category type. Possible values are

ACCOUNT\_UPDATE, PAYMENT\_UPDATE, PERSONAL\_FINANCE\_UPDATE, SHIPPING\_UPDATE, RESERVATION\_UPDATE, ISSUE\_RESOLUTION, APPOINTMENT\_UPDATE, TRANSPORTATION\_UPDATE, TICKET\_UPDATE, ALERT\_UPDATE, AUTO\_REPLY

| String | | template\_type |

Template type. Possible values are

header\_footer or body\_only

| String | | messages\[] | List containing information on each template translation. The size of this list is equivalent to the number of supported languages in languages | \[Object] | | messages\[].status |

Template status. Possible values are:

in\_analysis, approved, disapproved, error

In order for a template to be approved, its content must follow Facebook’s guidelines.

​​

| String | | messages\[].header\_type |

Header type. Possible values are

video, location, text, document, image or none

| String | | messages\[].header | Text contained in the text header. Only used when header\_type = text | String | | messages\[].text | Text contained in the body | String | | messages\[].footer | Text contained in the footer | String | | messages\[].buttons\_type |

Button type. Possible values are

quick\_reply or call\_to\_action

| String | | messages\[].placeholders | Description of placeholders present in the body text, represented as {{1}}, {{2}}, etc. in the text field | \[String] | | messages\[].buttons.payload |

Button content in JSON format serialized as a string.

Quick reply buttons will be in {"payload": \[{"text": "button text"}]} format

Call-to-action buttons will be in

{"payload": \[{"url": "https:wavy.global/en", "text": "Access our website", "type": "url"}, {"text": "Call us", "type": "phone\_number", "country\_code": "55", "phone\_number": "11900000000"}]} format

| String | ## Message Template Examples Template with a text header, body and footer: Template with an image header, body and no footer: Template with 2 parameters: --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs-latam.messaging.sinch.com/technical-documentation/api-and-integrations/listing-message-templates.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.