API referenceTemplates
List templates
Return a paginated list of templates owned by the authenticated user.
List templates
Returns templates belonging to the authenticated user (or to an organization the user is a member of, when organization_id is supplied).
Signature
GET /api/v1/templatesPermissions
API key scope: read or higher.
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
skip | integer | no | Number of records to skip. Default 0. |
limit | integer | no | Maximum records to return. Default 100. Max 500. |
search | string | no | Filter by case-insensitive substring match on template name. |
organization_id | integer | no | Filter by organization. Omit for the user's personal templates. |
Example
curl "https://api.simplyfill.app/v1/templates?limit=20&search=invoice" \
-H "Authorization: Bearer $SIMPLYFILL_API_KEY"const { templates, total } = await client.templates.list({
limit: 20,
search: 'invoice'
})result = client.templates.list(limit=20, search="invoice")
print(result.total, len(result.templates))Response
{
"templates": [
{
"id": 123,
"name": "Invoice Template",
"description": "Standard invoice",
"filename": "invoice.pdf",
"field_count": 14,
"current_version": 3,
"draft_status": "published",
"default_environment": "production",
"created_at": "2026-04-12T18:11:02Z",
"updated_at": "2026-05-09T20:44:18Z"
}
],
"total": 1
}