List templates▾
GET

List templates

Every template on the account with its Meta review status and quality rating.

A template exists once per name per language. Filter by status to find what is actually sendable right now.

GET/v1/templates

Query parameters

statusenum

Meta review status.

PENDINGAPPROVEDREJECTEDPAUSEDDISABLED

categoryenum

Template category.

MARKETINGUTILITYAUTHENTICATION

languagestring

BCP-47 code.

limitintegerdefault 25

Page size, 1–100.

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

Responses

200OK
{
  "object": "list",
  "data": [
    {
      "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"
    }
  ],
  "has_more": false,
  "next_cursor": null
}
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