Skip to main content
GET
/
templates
List Templates
curl --request GET \
  --url https://app.lettr.com/api/templates \
  --header 'Authorization: Bearer <token>'
{
  "message": "Templates retrieved successfully.",
  "data": {
    "templates": [
      {
        "id": 1,
        "name": "Welcome Email",
        "slug": "welcome-email",
        "project_id": 5,
        "folder_id": 10,
        "created_at": "2025-01-15T10:00:00+00:00",
        "updated_at": "2025-01-20T14:30:00+00:00"
      }
    ],
    "pagination": {
      "total": 42,
      "per_page": 25,
      "current_page": 1,
      "last_page": 2
    }
  }
}
Returns a paginated list of templates for your team. Optionally filter by project using the project_id query parameter. Each template in the list includes its name, slug, project and folder assignment, and timestamps. To retrieve the full HTML content and version details for a specific template, use Get Template.

Authorizations

​
Authorization
string
header
required

API key for authentication

Query Parameters

​
project_id
integer

Project ID to retrieve templates from. If not provided, uses the team's default project.

Required range: x >= 1
​
per_page
integer
default:25

Number of results per page (1-100)

Required range: 1 <= x <= 100
​
page
integer
default:1

Page number

Required range: x >= 1

Response

List of templates retrieved successfully

Response containing a paginated list of templates

​
message
string
required

Human-readable response message

Example:

"Templates retrieved successfully."

​
data
object
required