> ## Documentation Index
> Fetch the complete documentation index at: https://developers.luminpdf.com/llms.txt
> Use this file to discover all available pages before exploring further.
# List Templates
> Returns a paginated list of templates in a Lumin Workspace.
This endpoint requires the following scope:
`templates`
```bash Request theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl --request GET \
--url 'https://api.luminpdf.com/v1/templates?page=1&limit=25' \
--header 'X-API-Key: ' \
--header 'X-Lumin-API-Version: 1.1'
```
```json Response theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
"page": 1,
"limit": 25,
"total_count": 3,
"data": [
{
"template_id": "sign_123456",
"type": "pdf",
"name": "Mutual NDA",
"created_at": 1748456885430,
"updated_at": 1748456885430
}
]
}
```
## OpenAPI
````yaml GET /templates
openapi: 3.1.0
info:
version: 1.0.0
title: Lumin API Reference
description: >
The Lumin API Reference provides a comprehensive set of tools to integrate
document workflows — including editing, eSignatures, and automation — into
your applications.
Useful links:
- [Document Repository](https://github.com/luminpdf/luminsign-docs)
- [API
Definition](https://github.com/luminpdf/luminsign-docs/blob/main/openapi.yaml)
- [Authentication Guide](/tabs/guides/authentication/overview)
termsOfService: https://www.luminpdf.com/terms-of-use/
contact:
name: API Support
email: integration@luminpdf.com
url: https://help.luminpdf.com
servers:
- url: https://api.luminpdf.com/v1
description: Production server
security: []
tags:
- name: Signature Requests
description: Everything about Signature Requests
- name: Users
description: Everything about Users
- name: Templates
description: Everything about Templates
- name: Documents
description: Everything about Documents
- name: Workspaces
description: Everything about Workspaces
- name: Agreements
description: Everything about Agreements
paths:
/templates:
get:
tags:
- Templates
summary: List Templates
description: >
Returns a paginated list of templates in a Lumin Workspace, including
AgreementGen, Sign and PDF templates.
parameters:
- name: page
in: query
description: Specify which page of the dataset to return (min = 1).
required: true
example: 1
schema:
type: integer
minimum: 1
- name: limit
in: query
description: 'Specify how many templates to return: one of 10, 25, 50.'
required: true
example: 25
schema:
type: integer
enum:
- 10
- 25
- 50
- name: X-Lumin-API-Version
in: header
description: API version header
schema:
type: string
default: '1.1'
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/TemplateListResponse'
example:
page: 1
limit: 25
total_count: 3
data:
- template_id: sign_123456
type: pdf
name: Mutual NDA
created_at: 1748456885430
updated_at: 1748456885430
- template_id: ag_456789
type: lumin
name: Lease Agreement
created_at: 1748456885430
updated_at: 1748456885430
- template_id: pdf_456789
type: pdf
name: Onboarding Form
created_at: 1748456885430
updated_at: 1748456885430
4XX:
description: Unexpected error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
security:
- ApiKey: []
- BearerAuth:
- templates
components:
schemas:
TemplateListResponse:
type: object
properties:
page:
type: integer
description: The current page of results being returned.
limit:
type: integer
description: >-
The maximum number of template records shown per page (e.g., 10, 25,
or 50).
total_count:
type: integer
description: The total number of template records returned.
data:
type: array
description: >-
The list of templates returned. Each object contains full details
about one template.
items:
$ref: '#/components/schemas/TemplateListItem'
Error:
type: object
required:
- error_code
- error_message
properties:
error_code:
type: string
description: The system error code.
error_message:
type: string
description: The human-readable error message.
TemplateListItem:
type: object
properties:
template_id:
type: string
description: Unique identifier for the template
type:
type: string
description: 'Template file type. One of: pdf, lumin'
enum:
- pdf
- lumin
name:
type: string
description: Name of the template
created_at:
type: integer
format: unix-epoch
description: The Unix timestamp when the template was first created.
updated_at:
type: integer
format: unix-epoch
description: The Unix timestamp of the last update to the template.
securitySchemes:
ApiKey:
type: apiKey
in: header
name: X-API-Key
description: >
Provide your API key in the `X-API-Key` header, e.g., `X-API-Key:
YOUR_API_KEY`.
BearerAuth:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://auth.luminpdf.com/oauth2/auth
tokenUrl: https://auth.luminpdf.com/oauth2/token
scopes:
openid: >-
Retrieve basic identity details (username, email, profile
picture).
offline_access: Request a refresh token for long-lived access. Private apps only.
profile.read: View basic user profile information.
workspaces: View and manage Workspaces and Spaces.
workspaces.read: View information about the authenticated user's Workspace.
templates: View and manage templates in a Workspace.
pdf:files: Create, edit, and delete PDF files in a Workspace.
pdf:files.read: Retrieve PDF documents stored in a Workspace.
sign:requests: Create, update, or view signature requests.
sign:requests.read: Retrieve signature requests.
agreements: Create, update, or delete AgreementGen documents.
description: >
OAuth 2.0 authorization code flow. Provide your access token in the
`Authorization` header, e.g., `Authorization: Bearer `. See the
[OAuth 2.0 guide](/tabs/guides/authentication/oauth2) for details.
````