# GET /templates — Get Templates > Product: **Pabbly Chatflow** (v1) > Base URL: `https://chatflow.pabbly.com/api/v1` > Auth: Bearer via `Authorization` header > Canonical: `/chatflow/templates/get-templates` Hit the API with GET method and fill the following data according your requirements to fetch message templates. Query Params: **Query parameters:** | Name | Type | Required | Description | |------|------|----------|-------------| | all | string | No | If you want to fetch all templates, pass the all parameter in query params with any truthy value. | | limit | string | No | If you want to fetch a limited number of templates, pass the limit parameter in query params with a numeric value. Default Value: 50 | | page | string | No | If you want to fetch templates from a specific page, pass the page parameter in query params with a numeric value. Default Value: 1 | **Response (200)** — Get Paginated Templates: ```json { "status": "success", "message": "Templates fetched successfully", "data": { "templates": [ { "_id": "67a3182524676e664e58f8bd", "settingId": "6764020afc60086212ad5119", "waTemplateId": "1299480884626054", "name": "market_bros", "language": "en", "components": [ { "type": "HEADER", "format": "IMAGE", "example": { "header_handle": [ "https://scontent.whatsapp.net/v/t61.29466-34/454641900_1299480887959387_7502014456909389945_n.jpg?ccb=1-7&_nc_sid=8b1bef&_nc_ohc=XmjEPF_8nc0Q7kNvgG7Epcv&_nc_zt=3&_nc_ht=scontent.whatsapp.net&edm=AH51TzQEAAAA&_nc_gid=Ac2Kyb_CMTcjNzByxdal1Zp&oh=01_Q5AaIAfWpnNJzfkZqjjED3TwWEBWfMPi9Bs2gmLA19KH114n&oe=67CAA3C0" ] } }, { "type": "BODY", "text": "Some caption for marketing image" } ], "status": "APPROVED", "category": "MARKETING", "__v": 0, "createdAt": "2025-02-05T07:49:57.300Z", "updatedAt": "2025-02-05T07:49:57.300Z", "type": "image" }, { "_id": "67a3182524676e664e58f8be", "settingId": "6764020afc60086212ad5119", "waTemplateId": "584789171207477", "name": "interactive_marketing", "language": "en_GB", "components": [ { "type": "HEADER", "format": "TEXT", "text": "Hello {{1}}", "example": { "header_text": [ "Sir" ] } }, { "type": "BODY", "text": "Hope you are {{1}}.\n\nToday I want to introduce you to our new {{2}} {{3}}. {{4}} is our latest innovation, please do checkout and feel free to contact us.", "example": { "body_text": [ [ "doing well", "product", "Shalimar", "Shalimar" ] ] } }, { "type": "FOOTER", "text": "Thank You" }, { "type": "BUTTONS", "buttons": [ { "type": "COPY_CODE", "text": "Copy offer code", "example": [ "Shalimar" ] }, { "type": "QUICK_REPLY", "text": "Sure I will do" }, { "type": "QUICK_REPLY", "text": "Not interested" }, { "type": "QUICK_REPLY", "text": "Opt-out" }, { "type": "QUICK_REPLY", "text": "Okay" } ] } ], "status": "APPROVED", "category": "MARKETING", "__v": 0, "createdAt": "2025-02-05T07:49:57.301Z", "updatedAt": "2025-02-05T07:49:57.301Z" }, { "_id": "67a3182524676e664e58f8bf", "settingId": "6764020afc60086212ad5119", "waTemplateId": "585273447604143", "name": "marketing_template", "language": "en_GB", "components": [ { "type": "HEADER", "format": "TEXT", "text": "Hi {{1}}", "example": { "header_text": [ "$Name" ] } }, { "type": "BODY", "text": "How are you {{1}}? It is to meet & discuss with you.", "example": { "body_text": [ [ "$FirstName" ] ] } } ], "status": "APPROVED", "category": "MARKETING", "__v": 0, "createdAt": "2025-02-05T07:49:57.301Z", "updatedAt": "2025-02-05T07:49:57.301Z" }, { "_id": "67a3182524676e664e58f8c0", "settingId": "6764020afc60086212ad5119", "waTemplateId": "858893156254595", "name": "link_docs", "language": "en", "components": [ { "type": "HEADER", "format": "DOCUMENT", "example": { "header_handle": [ "https://scontent.whatsapp.net/v/t61.29466-34/473399444_858893162921261_7840692266964023941_n.pdf?ccb=1-7&_nc_sid=8b1bef&_nc_ohc=Ehtwa_m_4UYQ7kNvgGaLf8b&_nc_zt=3&_nc_ht=scontent.whatsapp.net&edm=AH51TzQEAAAA&_nc_gid=Ac2Kyb_CMTcjNzByxdal1Zp&oh=01_Q5AaIHduDzzpcec26JziX5DEo7JKW0y3-uPIkV4uopcluPMX&oe=67CA8D91" ] } }, { "type": "BODY", "text": "This is documentation about links. {{1}}", "example": { "body_text": [ [ "Thanks" ] ] } } ], "status": "APPROVED", "category": "UTILITY", "__v": 0, "createdAt": "2025-02-05T07:49:57.301Z", "updatedAt": "2025-02-05T07:49:57.301Z", "type": "document" }, { "_id": "67a3182524676e664e58f8c1", "settingId": "6764020afc60086212ad5119", "waTemplateId": "622915550124046", "name": "video_with_param", "language": "en", "components": [ { "type": "HEADER", "format": "VIDEO", "example": { "header_handle": [ "https://scontent.whatsapp.net/v/t61.29466-34/473397565_622915553457379_794576164898131124_n.mp4?ccb=1-7&_nc_sid=8b1bef&_nc_ohc=LaZmMRCrnS0Q7kNvgFgx1i4&_nc_zt=28&_nc_ht=scontent.whatsapp.net&edm=AH51TzQEAAAA&_nc_gid=Ac2Kyb_CMTcjNzByxdal1Zp&oh=01_Q5AaILuvux2gbuENEpezvpp-SAETv7VCa-smzd3V9Ub48_fa&oe=67CAA43A" ] } }, { "type": "BODY", "text": "Hello {{1}} Sir, {{2}} are you doing?", "example": { "body_text": [ [ "John", "how" ] ] } } ], "status": "APPROVED", "category": "MARKETING", "__v": 0, "createdAt": "2025-02-05T07:49:57.301Z", "updatedAt": "2025-02-05T07:49:57.301Z", "type": "video" }, { "_id": "67a3182524676e664e58f8c2", "settingId": "6764020afc60086212ad5119", "waTemplateId": "620215123719891", "name": "a_marketing_strategy", "language": "en", "components": [ { "type": "BODY", "text": "Hello $Name, We hope you are doing great. Its being a while, we didn't get any order from you to recharge your $MobileNumber. \nI will wait for your response." }, { "type": "FOOTER", "text": "Thank You" } ], "status": "APPROVED", "category": "MARKETING", "__v": 0, "createdAt": "2025-02-05T07:49:57.301Z", "updatedAt": "2025-02-05T07:49:57.301Z" }, { "_id": "67a3182524676e664e58f8c3", "settingId": "6764020afc60086212ad5119", "waTemplateId": "2082543462198881", "name": "video_template", "language": "en", "components": [ { "type": "HEADER", "format": "VIDEO", "example": { "header_handle": [ "https://scontent.whatsapp.net/v/t61.29466-34/472012574_2082543465532214_3272027660724285081_n.mp4?ccb=1-7&_nc_sid=8b1bef&_nc_ohc=9uB8Thb9fQ8Q7kNvgEfoT0p&_nc_zt=28&_nc_ht=scontent.whatsapp.net&edm=AH51TzQEAAAA&_nc_gid=Ac2Kyb_CMTcjNzByxdal1Zp&oh=01_Q5AaIGRmceK8Pepj-OarbUNg_zfv84tPsuFm8aFCRhXVWi1V&oe=67CA9B4B" ] } }, { "type": "BODY", "text": "some video template" } ], "status": "APPROVED", "category": "MARKETING", "__v": 0, "createdAt": "2025-02-05T07:49:57.301Z", "updatedAt": "2025-02-05T07:49:57.301Z", "type": "video" }, { "_id": "67a3182524676e664e58f8c4", "settingId": "6764020afc60086212ad5119", "waTemplateId": "1114497243654397", "name": "demo_text", "language": "en", "components": [ { "type": "BODY", "text": "Some demo text {{1}}", "example": { "body_text": [ [ "body" ] ] } } ], "status": "APPROVED", "category": "MARKETING", "__v": 0, "createdAt": "2025-02-05T07:49:57.301Z", "updatedAt": "2025-02-05T07:49:57.301Z", "type": "text" }, { "_id": "67a3182524676e664e58f8c5", "settingId": "6764020afc60086212ad5119", "waTemplateId": "598211256133695", "name": "alpha_city", "language": "en", "components": [ { "type": "BODY", "text": "This is an alpha city, all you see here is alpha peoples." } ], "status": "APPROVED", "category": "MARKETING", "__v": 0, "createdAt": "2025-02-05T07:49:57.301Z", "updatedAt": "2025-02-05T07:49:57.301Z" }, { "_id": "67a3182524676e664e58f8c6", "settingId": "6764020afc60086212ad5119", "waTemplateId": "8913023088785051", "name": "welcome_template", "language": "en", "components": [ { "type": "HEADER", "format": "TEXT", "text": "Hello {{1}}", "example": { "header_text": [ "Sunny" ] } }, { "type": "BODY", "text": "How are you? hope you are doing well." }, { "type": "FOOTER", "text": "Thanks for being connected" } ], "status": "APPROVED", "category": "MARKETING", "__v": 0, "createdAt": "2025-02-05T07:49:57.301Z", "updatedAt": "2025-02-05T07:49:57.301Z" } ], "pagination": { "totalTemplates": 12, "totalPages": 2, "currentPage": 1, "limit": 10, "hasNextPage": true, "hasPrevPage": false } } } ``` **Response (200)** — Get All Templates: ```json { "status": "success", "message": "Templates fetched successfully", "data": { "templates": [ { "_id": "67a3182524676e664e58f8bd", "settingId": "6764020afc60086212ad5119", "waTemplateId": "1299480884626054", "name": "market_bros", "language": "en", "components": [ { "type": "HEADER", "format": "IMAGE", "example": { "header_handle": [ "https://scontent.whatsapp.net/v/t61.29466-34/454641900_1299480887959387_7502014456909389945_n.jpg?ccb=1-7&_nc_sid=8b1bef&_nc_ohc=XmjEPF_8nc0Q7kNvgG7Epcv&_nc_zt=3&_nc_ht=scontent.whatsapp.net&edm=AH51TzQEAAAA&_nc_gid=Ac2Kyb_CMTcjNzByxdal1Zp&oh=01_Q5AaIAfWpnNJzfkZqjjED3TwWEBWfMPi9Bs2gmLA19KH114n&oe=67CAA3C0" ] } }, { "type": "BODY", "text": "Some caption for marketing image" } ], "status": "APPROVED", "category": "MARKETING", "__v": 0, "createdAt": "2025-02-05T07:49:57.300Z", "updatedAt": "2025-02-05T07:49:57.300Z", "type": "image" }, { "_id": "67a3182524676e664e58f8be", "settingId": "6764020afc60086212ad5119", "waTemplateId": "584789171207477", "name": "interactive_marketing", "language": "en_GB", "components": [ { "type": "HEADER", "format": "TEXT", "text": "Hello {{1}}", "example": { "header_text": [ "Sir" ] } }, { "type": "BODY", "text": "Hope you are {{1}}.\n\nToday I want to introduce you to our new {{2}} {{3}}. {{4}} is our latest innovation, please do checkout and feel free to contact us.", "example": { "body_text": [ [ "doing well", "product", "Shalimar", "Shalimar" ] ] } }, { "type": "FOOTER", "text": "Thank You" }, { "type": "BUTTONS", "buttons": [ { "type": "COPY_CODE", "text": "Copy offer code", "example": [ "Shalimar" ] }, { "type": "QUICK_REPLY", "text": "Sure I will do" }, { "type": "QUICK_REPLY", "text": "Not interested" }, { "type": "QUICK_REPLY", "text": "Opt-out" }, { "type": "QUICK_REPLY", "text": "Okay" } ] } ], "status": "APPROVED", "category": "MARKETING", "__v": 0, "createdAt": "2025-02-05T07:49:57.301Z", "updatedAt": "2025-02-05T07:49:57.301Z" }, { "_id": "67a3182524676e664e58f8bf", "settingId": "6764020afc60086212ad5119", "waTemplateId": "585273447604143", "name": "marketing_template", "language": "en_GB", "components": [ { "type": "HEADER", "format": "TEXT", "text": "Hi {{1}}", "example": { "header_text": [ "$Name" ] } }, { "type": "BODY", "text": "How are you {{1}}? It is to meet & discuss with you.", "example": { "body_text": [ [ "$FirstName" ] ] } } ], "status": "APPROVED", "category": "MARKETING", "__v": 0, "createdAt": "2025-02-05T07:49:57.301Z", "updatedAt": "2025-02-05T07:49:57.301Z" }, { "_id": "67a3182524676e664e58f8c0", "settingId": "6764020afc60086212ad5119", "waTemplateId": "858893156254595", "name": "link_docs", "language": "en", "components": [ { "type": "HEADER", "format": "DOCUMENT", "example": { "header_handle": [ "https://scontent.whatsapp.net/v/t61.29466-34/473399444_858893162921261_7840692266964023941_n.pdf?ccb=1-7&_nc_sid=8b1bef&_nc_ohc=Ehtwa_m_4UYQ7kNvgGaLf8b&_nc_zt=3&_nc_ht=scontent.whatsapp.net&edm=AH51TzQEAAAA&_nc_gid=Ac2Kyb_CMTcjNzByxdal1Zp&oh=01_Q5AaIHduDzzpcec26JziX5DEo7JKW0y3-uPIkV4uopcluPMX&oe=67CA8D91" ] } }, { "type": "BODY", "text": "This is documentation about links. {{1}}", "example": { "body_text": [ [ "Thanks" ] ] } } ], "status": "APPROVED", "category": "UTILITY", "__v": 0, "createdAt": "2025-02-05T07:49:57.301Z", "updatedAt": "2025-02-05T07:49:57.301Z", "type": "document" }, { "_id": "67a3182524676e664e58f8c1", "settingId": "6764020afc60086212ad5119", "waTemplateId": "622915550124046", "name": "video_with_param", "language": "en", "components": [ { "type": "HEADER", "format": "VIDEO", "example": { "header_handle": [ "https://scontent.whatsapp.net/v/t61.29466-34/473397565_622915553457379_794576164898131124_n.mp4?ccb=1-7&_nc_sid=8b1bef&_nc_ohc=LaZmMRCrnS0Q7kNvgFgx1i4&_nc_zt=28&_nc_ht=scontent.whatsapp.net&edm=AH51TzQEAAAA&_nc_gid=Ac2Kyb_CMTcjNzByxdal1Zp&oh=01_Q5AaILuvux2gbuENEpezvpp-SAETv7VCa-smzd3V9Ub48_fa&oe=67CAA43A" ] } }, { "type": "BODY", "text": "Hello {{1}} Sir, {{2}} are you doing?", "example": { "body_text": [ [ "John", "how" ] ] } } ], "status": "APPROVED", "category": "MARKETING", "__v": 0, "createdAt": "2025-02-05T07:49:57.301Z", "updatedAt": "2025-02-05T07:49:57.301Z", "type": "video" }, { "_id": "67a3182524676e664e58f8c2", "settingId": "6764020afc60086212ad5119", "waTemplateId": "620215123719891", "name": "a_marketing_strategy", "language": "en", "components": [ { "type": "BODY", "text": "Hello $Name, We hope you are doing great. Its being a while, we didn't get any order from you to recharge your $MobileNumber. \nI will wait for your response." }, { "type": "FOOTER", "text": "Thank You" } ], "status": "APPROVED", "category": "MARKETING", "__v": 0, "createdAt": "2025-02-05T07:49:57.301Z", "updatedAt": "2025-02-05T07:49:57.301Z" }, { "_id": "67a3182524676e664e58f8c3", "settingId": "6764020afc60086212ad5119", "waTemplateId": "2082543462198881", "name": "video_template", "language": "en", "components": [ { "type": "HEADER", "format": "VIDEO", "example": { "header_handle": [ "https://scontent.whatsapp.net/v/t61.29466-34/472012574_2082543465532214_3272027660724285081_n.mp4?ccb=1-7&_nc_sid=8b1bef&_nc_ohc=9uB8Thb9fQ8Q7kNvgEfoT0p&_nc_zt=28&_nc_ht=scontent.whatsapp.net&edm=AH51TzQEAAAA&_nc_gid=Ac2Kyb_CMTcjNzByxdal1Zp&oh=01_Q5AaIGRmceK8Pepj-OarbUNg_zfv84tPsuFm8aFCRhXVWi1V&oe=67CA9B4B" ] } }, { "type": "BODY", "text": "some video template" } ], "status": "APPROVED", "category": "MARKETING", "__v": 0, "createdAt": "2025-02-05T07:49:57.301Z", "updatedAt": "2025-02-05T07:49:57.301Z", "type": "video" }, { "_id": "67a3182524676e664e58f8c4", "settingId": "6764020afc60086212ad5119", "waTemplateId": "1114497243654397", "name": "demo_text", "language": "en", "components": [ { "type": "BODY", "text": "Some demo text {{1}}", "example": { "body_text": [ [ "body" ] ] } } ], "status": "APPROVED", "category": "MARKETING", "__v": 0, "createdAt": "2025-02-05T07:49:57.301Z", "updatedAt": "2025-02-05T07:49:57.301Z", "type": "text" }, { "_id": "67a3182524676e664e58f8c5", "settingId": "6764020afc60086212ad5119", "waTemplateId": "598211256133695", "name": "alpha_city", "language": "en", "components": [ { "type": "BODY", "text": "This is an alpha city, all you see here is alpha peoples." } ], "status": "APPROVED", "category": "MARKETING", "__v": 0, "createdAt": "2025-02-05T07:49:57.301Z", "updatedAt": "2025-02-05T07:49:57.301Z" }, { "_id": "67a3182524676e664e58f8c6", "settingId": "6764020afc60086212ad5119", "waTemplateId": "8913023088785051", "name": "welcome_template", "language": "en", "components": [ { "type": "HEADER", "format": "TEXT", "text": "Hello {{1}}", "example": { "header_text": [ "Sunny" ] } }, { "type": "BODY", "text": "How are you? hope you are doing well." }, { "type": "FOOTER", "text": "Thanks for being connected" } ], "status": "APPROVED", "category": "MARKETING", "__v": 0, "createdAt": "2025-02-05T07:49:57.301Z", "updatedAt": "2025-02-05T07:49:57.301Z" }, { "_id": "67a3182524676e664e58f8c7", "settingId": "6764020afc60086212ad5119", "waTemplateId": "1072732384643636", "name": "crypto_installations", "language": "en_US", "components": [ { "type": "HEADER", "format": "IMAGE", "example": { "header_handle": [ "https://scontent.whatsapp.net/v/t61.29466-34/462460818_1072732387976969_5335450883540686871_n.jpg?ccb=1-7&_nc_sid=8b1bef&_nc_ohc=q8JMIJAD_-AQ7kNvgGIMCfL&_nc_zt=3&_nc_ht=scontent.whatsapp.net&edm=AH51TzQEAAAA&_nc_gid=Ac2Kyb_CMTcjNzByxdal1Zp&oh=01_Q5AaIKrCeOaXTqkeCmlgHgjvLD9cT4lTcqNkoy_Od7Tgic7E&oe=67CA9DD5" ] } }, { "type": "BODY", "text": "Follow the attached document to install your product." }, { "type": "FOOTER", "text": "For more support, visit our website." } ], "status": "APPROVED", "category": "MARKETING", "__v": 0, "createdAt": "2025-02-05T07:49:57.301Z", "updatedAt": "2025-02-05T07:49:57.301Z" }, { "_id": "67a3182524676e664e58f8c8", "settingId": "6764020afc60086212ad5119", "waTemplateId": "1005446854678735", "name": "hello_world", "language": "en_US", "components": [ { "type": "HEADER", "format": "TEXT", "text": "Hello World" }, { "type": "BODY", "text": "Welcome and congratulations!! This message demonstrates your ability to send a WhatsApp message notification from the Cloud API, hosted by Meta. Thank you for taking the time to test with us." }, { "type": "FOOTER", "text": "WhatsApp Business Platform sample message" } ], "status": "APPROVED", "category": "UTILITY", "__v": 0, "createdAt": "2025-02-05T07:49:57.301Z", "updatedAt": "2025-02-05T07:49:57.301Z" } ] } } ``` **Code examples:** _cURL_ ```curl curl https://chatflow.pabbly.com/api/v1/templates?all={{all}}&limit={{limit}}&page={{page}} \ -H "Authorization: Bearer {{YOUR_API_KEY}}" ``` _Ruby_ ```ruby require 'net/http' require 'json' uri = URI('https://chatflow.pabbly.com/api/v1/templates?all={{all}}&limit={{limit}}&page={{page}}') request = Net::HTTP::Get.new(uri) request['Authorization'] = 'Bearer {{YOUR_API_KEY}}' response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http| http.request(request) end data = JSON.parse(response.body) ``` _Python_ ```python import requests response = requests.get( 'https://chatflow.pabbly.com/api/v1/templates?all={{all}}&limit={{limit}}&page={{page}}', headers={'Authorization': 'Bearer {{YOUR_API_KEY}}'}, ) data = response.json() ``` _PHP_ ```php response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); ``` _Node.js_ ```node const response = await fetch('https://chatflow.pabbly.com/api/v1/templates?all={{all}}&limit={{limit}}&page={{page}}', { method: 'GET', headers: { 'Authorization': 'Bearer {{YOUR_API_KEY}}', }, }); const data = await response.json(); ``` _Go_ ```go package main import ( "fmt" "io" "net/http" ) func main() { req, _ := http.NewRequest("GET", "https://chatflow.pabbly.com/api/v1/templates?all={{all}}&limit={{limit}}&page={{page}}", nil) req.Header.Set("Authorization", "Bearer {{YOUR_API_KEY}}") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(string(body)) } ``` _.NET_ ```dotnet using System.Net.Http; using System.Net.Http.Headers; using System.Threading.Tasks; var client = new HttpClient(); var request = new HttpRequestMessage(HttpMethod.Get, "https://chatflow.pabbly.com/api/v1/templates?all={{all}}&limit={{limit}}&page={{page}}"); request.Headers.TryAddWithoutValidation("Authorization", "Bearer {{YOUR_API_KEY}}"); var response = await client.SendAsync(request); var data = await response.Content.ReadAsStringAsync(); Console.WriteLine(data); ``` --- **Other endpoints in Templates:** - [GET /templates/{{identifier}} — Get Template By Name/Id](/chatflow/templates/get-template-by-name-id)