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