--- updatedAt: 2026-01-22T07:05:49.000Z agentTools: projectIndex: https://partner-docs.gupshup.io/llms.txt --- # Get Templates Using this API you can get the list of templates for a an app. You will get the rejection reason for templates. The response in which inside containerMeta there will be a field correctCategory if meta has identified the miscategorization for this template. **Note** - Starting June 1, 2024, to ensure that all templates are correctly categorized, Meta has implemented a recurring process that automatically identifies and updates the category of any marketing or utility templates that have been miscategorized, according to their guidelines. In this process, meta will now send two webhook events for template_category_update. 1. The first one is the alert event which informs about the template’s current category and the correct category it belongs to. 2. The second event (sent on the 1st of the next month after the alert event) is the actual category update event informing that the template’s category has now been updated.
## Request Parameters | Key | Description | Value | Data type | Required/Optional | Constraints | | :--------------- | :--------------------------------------------------- | :--------------------- | :-------- | :---------------- | :------------------------------------------------------------------------------------------------------------------------------------- | | Authorization | Access Token for the application | \{PARTNER\_APP\_TOKEN} | String | Required | • Should be a valid Partner App Access Token | | **Path Params** | | | | | | | appId | App ID to fetch the access token | \{APP\_ID} | String | Required | • The Id should be a valid app Id of Gupshup• The App must be associated with the account that owns the PARTNER\_APP\_TOKEN being used | | **Query Params** | | | | | | | templateType | Type of template | \{TEMPLATE\_TYPE} | String | Optional | | | status | Status of template | \{STATUS} | String | Optional | | | stage | List of stages to filter by, separated by commas | \{STAGES} | String | Optional | | | useable | To filter templates which are useable ,i.e, APPROVED | \{USABLE} | Boolean | Optional | | | startTime | Time range start time | \{START\_TIME} | Long | Optional | | | endTime | Time range end time | \{END\_TIME} | Long | Optional | | | elementName | Template element name to filter by | \{ELEMENT\_NAME} | String | Optional | | | data | Template data to filter by | \{DATA} | String | Optional | | | pageNo | Page number | \{PAGE\_NO} | INT | Optional | | | pageSize | Page size | \{PAGE\_SIZE} | INT | Optional | | ## Sample Request ```curl curl --location --globoff 'https:partner.gupshup.io/partner/app/{{APP_ID}}/templates?templateType={{TEMPLATE_TYPE}}&status={{STATUS}}&startTime={{START_TIME}}&endTime={{END_TIME}}&pageSize={{PAGE_SIZE}}&pageNo={{PAGE_NO}}&stage={{STATE}}&data={{DATA}}&useable={{USEABLE}}&elementName={{ELEMENT_NAME}}' \ --header 'Authorization: {{PARTNER_APP_TOKEN}}' ``` ## Sample Response ```json { "status": "success", "templates": [ { "appId": "bf9ee64c-3d4d-4ac4-8668-732e577007c4", "category": "UTILITY", "containerMeta": "{\"appId\":\"bf9ee64c-3d4d-4ac4-8668-732e577007c4\",\"data\":\"This is to remind you that {{1}} is due by {{2}}.\",\"footer\":\"This is footer\",\"sampleText\":\"This is to remind you that {{1}} is due by {{2}}.\",\"enableSample\":true,\"editTemplate\":false,\"allowTemplateCategoryChange\":true,\"addSecurityRecommendation\":false}", "createdOn": 1707743909374, "data": "This is to remind you that {{1}} is due by {{2}}.\nThis is footer", "elementName": "automation_template_2131081", "externalId": "1508119726419684", "id": "00b8d1ed-7af6-4734-a7a1-e3062f21d7df", "languageCode": "en", "languagePolicy": "deterministic", "meta": "{\"example\":\"This is to remind you that {{1}} is due by {{2}}.\"}", "modifiedOn": 1707743915378, "namespace": "18cfa544_9c62_4dcd_b8f3_b3785d8c917c", "priority": 2, "quality": "UNKNOWN", "reason": "Invalid Format", "retry": 0, "stage": "NONE", "status": "REJECTED", "templateType": "TEXT", "vertical": "Internal_vertical", "wabaId": "216141188246170" } } ``` ## Status Codes
Status Code Response Comments
**Success**
200 \{ "status": "success","template":\{"appId": "bf9ee64c-3d4d-4ac4-8668-732e577007c4","category": "MARKETING","containerMeta": "\{"appId":"bf9ee64c-3d4d-4ac4-8668-732e577007c4","data":"This is category for copy code button template.","footer":"This is footer","sampleText":"This is category for copy code button template.","enableSample":true,"editTemplate":false,"addSecurityRecommendation":false}","createdOn": 1708205191624,"data": "This is category for copy code button template.\nThis is footer","elementName": "automation_template_2956534","id": "e8e837c2-a3a8-4845-958f-ec7febb54aec","languageCode": "en","languagePolicy": "deterministic","meta": "\{"example":"This is category for copy code button template."}","modifiedOn": 1708205191624,"namespace": "18cfa544_9c62_4dcd_b8f3_b3785d8c917c","priority": 1,"quality": "UNKNOWN","retry": 0, "stage": "NONE", "status": "APPROVED", "templateType": "TEXT", "vertical": "Internal_vertical", "wabaId": "216141188246170" } }
**Error**
429 \{ "status": "error","message": "Too Many Requests"} 10 Requests per Minute
500 \{ "status": "error","message": "Internal server error. Please try again later and If Issue still persist, then contact Gupshup Dev Support"} For any Internal Error
# OpenAPI definition ```json { "openapi": "3.0.0", "info": { "title": "Get Templates 1", "version": "1.0.0" }, "servers": [ { "url": "https://partner.gupshup.io/" } ], "paths": { "/partner/app/{appId}/templates": { "get": { "tags": [ "default" ], "summary": "Get Templates", "parameters": [ { "name": "token", "in": "header", "schema": { "type": "string" }, "required": true, "description": "Your app token, please refer [**Get access token api**](https://partner-docs.gupshup.io/reference/get_partner-app-appid-token) to get the token from partner documentation.", "example": "sk_61b3021c97214370b341f8baaae0xxxx" }, { "name": "appId", "in": "path", "schema": { "type": "string" }, "required": true, "description": "Unique identifier of the app.", "example": "9e97650d-xxxx-xxxx-xxxx-4cdf47c3fa68" }, { "name": "templateType", "in": "query", "schema": { "type": "string" }, "required": false, "description": "Filter templates by template type (e.g., TEXT, CAROUSEL, etc.)." }, { "name": "useable", "in": "query", "schema": { "type": "boolean" }, "required": false, "description": "Filter templates by usable flag." }, { "name": "stages", "in": "query", "schema": { "type": "string" }, "required": false, "description": "List of stages to filter by, separated by commas." }, { "name": "elementName", "in": "query", "schema": { "type": "string" }, "required": false, "description": "Filter templates by element name." }, { "name": "startTime", "in": "query", "schema": { "type": "integer", "format": "int64" }, "required": false, "description": "Start time filter (epoch millis)." }, { "name": "endTime", "in": "query", "schema": { "type": "integer", "format": "int64" }, "required": false, "description": "End time filter (epoch millis)." }, { "name": "status", "in": "query", "schema": { "type": "string" }, "required": false, "description": "Filter templates by status (e.g., PENDING,APPROVED, REJECTED, SUBMITTED, DEACTIVATED, etc.)." }, { "name": "data", "in": "query", "schema": { "type": "string" }, "required": false, "description": "Filter templates by data/content." }, { "name": "pageNo", "in": "query", "schema": { "type": "integer", "format": "int32" }, "required": false, "description": "Page number for pagination." }, { "name": "pageSize", "in": "query", "schema": { "type": "integer", "format": "int32" }, "required": false, "description": "Page size for pagination." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string", "example": "success" }, "templates": { "type": "array", "items": { "type": "object", "properties": { "appId": { "type": "string", "example": "bf9ee64c-3d4d-4ac4-8668-732e577007c4" }, "category": { "type": "string", "example": "UTILITY" }, "containerMeta": { "type": "string", "example": null }, "createdOn": { "type": "integer", "format": "int64", "example": "1707743909374" }, "data": { "type": "string", "example": "This is to remind you that {{1}} is due by {{2}}. This is footer" }, "elementName": { "type": "string", "example": "automation_template_2131081" }, "externalId": { "type": "string", "example": "1508119726419684" }, "id": { "type": "string", "example": "00b8d1ed-7af6-4734-a7a1-e3062f21d7df" }, "languageCode": { "type": "string", "example": "en" }, "languagePolicy": { "type": "string", "example": "deterministic" }, "meta": { "type": "string", "example": null }, "modifiedOn": { "type": "integer", "format": "int64", "example": "1707743915378" }, "namespace": { "type": "string", "example": "18cfa544_9c62_4dcd_b8f3_b3785d8c917c" }, "priority": { "type": "integer", "format": "int32", "example": "2" }, "quality": { "type": "string", "example": "UNKNOWN" }, "reason": { "type": "string", "example": "Invalid Format" }, "retry": { "type": "integer", "format": "int32", "example": "0" }, "stage": { "type": "string", "example": "NONE" }, "status": { "type": "string", "example": "REJECTED" }, "templateType": { "type": "string", "example": "TEXT" }, "vertical": { "type": "string", "example": "Internal_vertical" }, "wabaId": { "type": "string", "example": "216141188246170" }, "internalCategory": { "type": "integer", "format": "int32", "example": "0" }, "internalType": { "type": "integer", "format": "int32", "example": "0" }, "oldCategory": { "type": "string", "example": "UTILITY" } } } } } } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Invalid app id provided" }, "status": { "type": "string", "example": "error" } } } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "You do not have the required permissions to access this API" }, "status": { "type": "string", "example": "error" } } } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "type": "object", "properties": { "message": { "type": "string", "example": "Internal error occured" }, "status": { "type": "string", "example": "error" } } } } } } } } } } } ```