---
title: "List quote templates"
method: GET
path: "/v1/quotes/templates"
tags: ["Quotes > Templates"]
---

# List quote templates

`GET /v1/quotes/templates`

Retrieve existing quote templates.

## Query parameters

- `take` number, nullable
- `skip` number, nullable
- `id` string
- `id__not` string
- `id__isNull` string
- `id__isNotNull` string
- `id__equals` string
- `id__contains` string
- `id__startsWith` string
- `id__endWith` string
- `name` string
- `name__not` string
- `name__isNull` string
- `name__isNotNull` string
- `name__equals` string
- `name__contains` string
- `name__startsWith` string
- `name__endWith` string
- `subscription_template_id` string
- `subscription_template_id__not` string
- `subscription_template_id__isNull` string
- `subscription_template_id__isNotNull` string
- `subscription_template_id__equals` string
- `subscription_template_id__contains` string
- `subscription_template_id__startsWith` string
- `subscription_template_id__endWith` string
- `search` string

## Response `200`

- PaginatedQuoteTemplate
  - `meta` object, required
    - `total` number, required — Total of existing items.
    - `taken` number, required — Number of items returned.
    - `skipped` number, required — Number of items skipped.
  - `data` QuoteTemplate[], required — List of QuoteTemplate.
    - `id` string, required — Quote template ID.
    - `name` string, required — Quote template name.
    - `description` string, nullable, required — Quote template description.
    - `comments` string, nullable, required — Default comments displayed on quotes created from the template.
    - `terms` string, nullable, required — Default terms displayed on quotes created from the template.
    - `expiration_days` integer, required — Number of days after creation before quotes created from the template expire.
    - `collect_payment_details` boolean, required — Whether quotes created from the template collect customer payment method details during signature.
    - `collect_shipping_details` boolean, required — Whether quotes created from the template collect customer shipping details during signature.
    - `collect_custom_property_ids` string[], required — IDs of customer custom properties required during quote signature.
    - `require_tax_id` boolean, required — Whether quotes created from the template require the customer to provide a tax ID during signature.
    - `require_billing_details` boolean, required — Whether quotes created from the template require customer billing details during signature.
    - `display_taxes` boolean, required — Whether quotes created from the template display taxes.
    - `display_price_tiers` 'all' | 'matching' | 'none', required — Controls which price tiers are displayed on the quote. - `all`: Display all pricing tiers. - `matching`: Only display the tiers used to compute the price based on quantity. - `none`: Hide all pricing tiers.
    - `display_phase_value` boolean, required — Whether quotes created from the template display per-phase value breakdown.
    - `display_quote_value` boolean, required — Whether quotes created from the template display total quote value.
    - `display_first_invoice_amount` boolean, required — Whether quotes created from the template display the first invoice amount.
    - `display_documents_in_preview` boolean, required — Whether quotes created from the template display attached documents in the quote preview.
    - `display_subscription_on_update` boolean, required — Whether subscription update quotes created from the template display subscription details.
    - `display_organisation_details` boolean, required — Whether quotes created from the template display organisation details.
    - `generate_draft_invoices` boolean, required — Whether invoices issued after quote signature stay in draft status instead of being emitted for payment.
    - `subscription_template_id` string, nullable, required — ID of the subscription template used by the quote template.
    - `contract_template_ids` string[], required — IDs of contract templates used by the quote template.
    - `contract_clause_ids` string[], required — IDs of contract clauses used by the quote template.
    - `attachments` QuoteTemplateAttachment[], required — List of documents attached to the quote template.
      - `id` string, required — Quote file ID.
      - `name` string, required — Quote file name.
      - `mimetype` string, required — Quote file MIME type.
    - `created_at` string, date-time, required — Quote template creation date. UTC date time string in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    - `updated_at` string, date-time, required — Quote template last edition date. UTC date time string in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.

---

[API](https://skmtc.dev/hyperline/apis/hyperline-api.md) · [All operations](https://skmtc.dev/hyperline/apis/hyperline-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hyperline/hyperline-api/revisions/19fa5f22e39b/schema)