curl --request GET \
--url https://app.thinnest.ai/api/v1/templates \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.thinnest.ai/api/v1/templates', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.thinnest.ai/api/v1/templates"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"items": [
{
"name": "order_ready",
"language": "en",
"category": "utility",
"status": "approved",
"agent": "ag_5c4a5f93-2b1e-4c0a-9d3f-7e8a1b2c3d4e",
"body": "Hello {{1}}, your Kesar Naturals order {{2}} is packed and on its way.",
"variableCount": 2,
"variableLabels": [
{
"position": 1,
"sample": "Priya"
},
{
"position": 2,
"sample": "#10432"
}
],
"buttonVariableCount": 1,
"headerKind": "none",
"createdAt": "2026-09-30T11:02:14.530Z"
},
{
"name": "diwali_offer_v2",
"language": "hi",
"category": "marketing",
"status": "pending",
"agent": "ag_5c4a5f93-2b1e-4c0a-9d3f-7e8a1b2c3d4e",
"body": "नमस्ते {{1}}, इस दिवाली हमारे सभी उत्पादों पर 20% की छूट। कोड {{2}} इस्तेमाल करें।",
"variableCount": 2,
"variableLabels": [
{
"position": 1,
"sample": "प्रिया"
},
{
"position": 2,
"sample": "FESTIVE20"
}
],
"buttonVariableCount": 0,
"headerKind": "image",
"createdAt": "2026-09-28T07:45:03.112Z"
}
],
"nextCursor": null
}{
"error": "`category` is one of utility, marketing, authentication."
}{
"error": "Send a valid API key as `Authorization: Bearer <key>`."
}{
"error": "Over 240 requests a minute. Slow down and retry."
}List Templates
Lists your workspace’s WhatsApp templates, newest first, with what a send needs from each: how many body values (variableCount), how many link-button values (buttonVariableCount) and whether the header needs a media link (headerKind). Only approved templates can be sent.
curl --request GET \
--url https://app.thinnest.ai/api/v1/templates \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://app.thinnest.ai/api/v1/templates', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.thinnest.ai/api/v1/templates"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"items": [
{
"name": "order_ready",
"language": "en",
"category": "utility",
"status": "approved",
"agent": "ag_5c4a5f93-2b1e-4c0a-9d3f-7e8a1b2c3d4e",
"body": "Hello {{1}}, your Kesar Naturals order {{2}} is packed and on its way.",
"variableCount": 2,
"variableLabels": [
{
"position": 1,
"sample": "Priya"
},
{
"position": 2,
"sample": "#10432"
}
],
"buttonVariableCount": 1,
"headerKind": "none",
"createdAt": "2026-09-30T11:02:14.530Z"
},
{
"name": "diwali_offer_v2",
"language": "hi",
"category": "marketing",
"status": "pending",
"agent": "ag_5c4a5f93-2b1e-4c0a-9d3f-7e8a1b2c3d4e",
"body": "नमस्ते {{1}}, इस दिवाली हमारे सभी उत्पादों पर 20% की छूट। कोड {{2}} इस्तेमाल करें।",
"variableCount": 2,
"variableLabels": [
{
"position": 1,
"sample": "प्रिया"
},
{
"position": 2,
"sample": "FESTIVE20"
}
],
"buttonVariableCount": 0,
"headerKind": "image",
"createdAt": "2026-09-28T07:45:03.112Z"
}
],
"nextCursor": null
}{
"error": "`category` is one of utility, marketing, authentication."
}{
"error": "Send a valid API key as `Authorization: Bearer <key>`."
}{
"error": "Over 240 requests a minute. Slow down and retry."
}Authorizations
Your API key (ta_live_…) from Settings → API keys, sent as Authorization: Bearer <key>. Keep it on a server: it can message every customer you have. A key is full, build or read-only; a request its level does not allow is refused with 403.
Headers
Developers only: the customer workspace this request acts in — its org_… id from POST /customers. Leave it out to act in your own workspace.
"org_3fKq9TzQ1mN8vB2xR7cLpA"
Query Parameters
Only templates in this review state.
draft, pending, approved, rejected, paused Only templates of this category.
utility, marketing, authentication How many items to return, 1 to 100.
1 <= x <= 100The nextCursor from the previous page. Leave it out for the first page.