Retrieve a template▾
GET

Retrieve a template

Fetch one template by name, with its review status and quality rating.

Names are unique per language, so pass language when a template exists in several.

GET/v1/templates/{name}

Path parameters

namestringrequired

Template name, or tpl_….

Query parameters

languagestring

Disambiguates a multi-language template.

curl -X GET https://api.sendport.tech/v1/templates/{name} \
  -H "Authorization: Bearer $SENDPORT_KEY"

Responses

200OK
{
  "object": "template",
  "id": "tpl_01JZQ9C3N5P7R9T1V3X5Z7BDFH",
  "name": "order_shipped",
  "language": "en",
  "category": "UTILITY",
  "status": "APPROVED",
  "quality_rating": "GREEN",
  "components": [
    { "type": "BODY", "text": "Your order {{1}} shipped and arrives on {{2}}." },
    { "type": "FOOTER", "text": "Reply STOP to opt out." }
  ],
  "created_at": "2026-07-02T09:41:00.000Z"
}
401Unauthorized
{
  "error": {
    "type": "authentication_error",
    "code": "missing_api_key",
    "message": "No API key provided.",
    "doc_url": "https://sendport.tech/docs/errors#missing_api_key",
    "request_id": "req_9f3c2a7b41de08c5b2e6"
  }
}
Try itsandbox