---
title: "List Templates"
method: GET
path: "/v1/templates"
tags: ["Templates"]
---

# List Templates

`GET /v1/templates`

## Request

- Base URL: `https://api.oviond.com`
- URL: `https://api.oviond.com/v1/templates`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

List templates for the current account.

## Query parameters

- `page` integer, nullable
- `limit` integer
- `search` string
- `sort_by` 'ranking' | 'created_at' | 'name'
- `sort_order` union
  - 'asc' | 'desc'
  - integer, nullable
- `datasources` union: Filter by datasource IDs (comma-separated or array; each a known datasource id)
  - string
  - string[]
- `source` 'all' | 'standard' | 'mine': all = both libraries merged, standard = Oviond templates, mine = this account's saved templates
- `type` 'REPORT' | 'DASHBOARD': Filter by report type

## Response `200`

Template list

- ListTemplatesResponse
  - `success` true, required
  - `data` Template[], required
    - `id` string, required
    - `account_id` string, required
    - `name` string, required
    - `description` string
    - `type` 'REPORT' | 'DASHBOARD'
    - `ranking` number
    - `datasources` string[]
    - `thumbnail` string
    - `date_range` DateRange
      - `text` 'Today' | 'Yesterday' | 'Last 7 Days' | 'Last 30 Days' | 'Last 60 Days' | 'Custom Days' | 'This Month' | 'Last Month' | 'Custom Months' | 'Last 2 Months' | 'Last 3 Months' | 'Last 12 Months' | 'This Year' | 'Last Year' | 'Custom'
      - `compare` 'None' | 'Period' | 'Month' | 'Year' | 'Custom'
      - `include_today` boolean
      - `current_start` string
      - `current_end` string
      - `previous_start` string
      - `previous_end` string
      - `custom_days` number
      - `custom_months` number
    - `theme_id` string, nullable
    - `logo_url` string, nullable
    - `orientation` 'portrait' | 'landscape'
    - `paper_size` 'a4' | 'letter', nullable
    - `branding_source` 'inherit' | 'client' | 'agency', nullable
    - `show_dashboard_navigation` boolean, nullable
    - `show_cover_page` boolean, nullable
    - `show_cover_page_logo` boolean, nullable
    - `show_cover_page_client_logo` boolean, nullable
    - `show_cover_page_agency_logo` boolean, nullable
    - `show_cover_page_name` boolean, nullable
    - `show_cover_page_date` boolean, nullable
    - `show_cover_page_bg_image` boolean, nullable
    - `show_header` boolean, nullable
    - `show_header_logo` boolean, nullable
    - `show_header_name` boolean, nullable
    - `show_header_date` boolean, nullable
    - `show_page_numbers` boolean, nullable
    - `show_table_of_contents` boolean, nullable
    - `show_date` boolean, nullable
    - `show_thank_you` boolean, nullable
    - `show_thank_you_bg_image` boolean, nullable
    - `show_thank_you_logo` boolean, nullable
    - `show_thank_you_client_logo` boolean, nullable
    - `show_thank_you_agency_logo` boolean, nullable
    - `show_thank_you_heading` boolean, nullable
    - `show_thank_you_message` boolean, nullable
    - `created_at` unknown
    - `source` 'standard' | 'mine'
  - `meta` object, required
    - `page` number, required
    - `limit` number, required
    - `total` number, required

---

[API](https://skmtc.dev/oviond/apis/oviond-backend-api.md) · [All operations](https://skmtc.dev/oviond/apis/oviond-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/oviond/apis/oviond-backend-api/revisions/4cb0a07daf41?raw)