List Templates

Retrieves a list of all templates available in your DocuSign account. Use this to discover template IDs and details for creating envelopes.

Overview

• Purpose: Get a list of all available templates with their IDs and metadata.
• Use Cases: Discovering template IDs, building template selectors in UI, auditing available templates.
• API Method: GET /templates

Optional Input Fields

Count: Maximum number of templates to return (pagination).

Folder IDs: Comma-separated list of folder IDs to filter templates by folder.

Search Text: Search for templates by name or description containing this text.

Output

Returns an array of template objects, each containing:

• Template ID: Unique identifier to use with ‘Create Envelope from Template’.
• Name: Template name.
• Description: Template description (if provided).
• Created: ISO 8601 timestamp when template was created.
• Last Modified: ISO 8601 timestamp of last modification.
• Shared: Whether the template is shared with other users.
• URI: DocuSign URI for the template.
• Total Set Size: Total number of templates matching the query.
• Result Set Size: Number of templates returned in this response.

Filtering and Pagination

• Count Parameter: Limit results to manage large template lists.
• Search Text: Find templates by partial name or description match.
• Folder Filtering: Organize templates by folders and filter accordingly.
• Result Sizes: Use totalSetSize and resultSetSize to implement pagination.

Tips

[!TIP] Use search text to quickly find specific templates by name

[!TIP] Store template IDs in your application configuration for quick access

[!TIP] Use count parameter to paginate through large template lists

[!TIP] Filter by folder to organize templates by department or use case

[!TIP] Call this action during application setup to cache available templates

[!TIP] Template IDs remain constant - safe to store long-term