Returns a paginated list of every contract template version belonging to the authenticated client, newest first. Each entry includes the template status, source file metadata, detected signer roles, fields, and template variables. This is a read-only endpoint with no side effects.

Authentication & access

• Requires a client API token: Authorization: Bearer <token>.
• The caller must hold the contracts.templates.read permission and have the OWNER, OPERATIONS, or DEVELOPER role.
• The client must have contract signing enabled. If the feature is disabled the request returns 403.

Query parameters

Results are ordered by creation time, newest first.

Response

200 — Returns an object with:

• templates — array of template version objects. Each contains id, name, status, file_type, external_id, the uploaded source_file metadata, the roles and fields defined on the template, detected_variables, and created_at / updated_at / published_at timestamps.
• pagination — object with total, page, page_size, and total_pages.

When the client has no templates, templates is an empty array and total is 0.

Error responses

Standard 401 (authentication), 403 (insufficient permission or role), and 429 (rate limit) responses apply to every endpoint and are documented in the Error reference.