> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mavioapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List templates

> Retrieve a list of available summary templates, including built-in and custom templates.

Returns all available summary templates. Templates define how meeting summaries are structured, including the sections to generate and the AI prompts used for each section. The list includes built-in templates provided by Mavio and any custom templates you have created.

<ParamField query="limit" type="integer" default="20">
  Number of templates to return per page. Must be between 1 and 100.
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Number of templates to skip for pagination.
</ParamField>

<ParamField query="type" type="string">
  Filter by template type. One of `built_in` (Mavio default templates) or `custom` (user-created templates).
</ParamField>

### Response

<ResponseField name="data" type="array">
  An array of template objects.

  <Expandable title="Template object">
    <ResponseField name="id" type="string">
      Unique template identifier (e.g., `tpl_a1b2c3d4e5`).
    </ResponseField>

    <ResponseField name="name" type="string">
      Template name displayed in the UI.
    </ResponseField>

    <ResponseField name="description" type="string">
      Brief description of the template's purpose and structure.
    </ResponseField>

    <ResponseField name="type" type="string">
      Template type: `built_in` or `custom`.
    </ResponseField>

    <ResponseField name="section_count" type="integer">
      Number of sections defined in the template.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp when the template was created.
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      ISO 8601 timestamp when the template was last modified.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object">
  Pagination metadata.

  <Expandable title="Pagination object">
    <ResponseField name="total" type="integer">
      Total number of templates matching the filters.
    </ResponseField>

    <ResponseField name="limit" type="integer">
      The limit used in this request.
    </ResponseField>

    <ResponseField name="offset" type="integer">
      The offset used in this request.
    </ResponseField>

    <ResponseField name="has_more" type="boolean">
      Whether there are more results beyond this page.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -G https://api.mavioapp.com/v1/templates \
    -H "Authorization: Bearer mvo_live_abc123" \
    -d type=built_in
  ```

  ```python Python theme={null}
  templates = client.templates.list(type="built_in")
  for t in templates.data:
      print(f"{t.name} — {t.section_count} sections ({t.type})")
  ```

  ```javascript Node.js theme={null}
  const { data: templates } = await client.templates.list({
    type: 'built_in',
  });
  templates.forEach(t => {
    console.log(`${t.name} — ${t.section_count} sections (${t.type})`);
  });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "id": "tpl_default_exec",
        "name": "Executive Summary",
        "description": "High-level overview with key decisions, action items, and next steps. Ideal for leadership updates.",
        "type": "built_in",
        "section_count": 4,
        "created_at": "2026-01-01T00:00:00Z",
        "updated_at": "2026-01-01T00:00:00Z"
      },
      {
        "id": "tpl_default_detailed",
        "name": "Detailed Notes",
        "description": "Comprehensive meeting notes organized by topic, with speaker attributions and timestamps.",
        "type": "built_in",
        "section_count": 6,
        "created_at": "2026-01-01T00:00:00Z",
        "updated_at": "2026-01-01T00:00:00Z"
      },
      {
        "id": "tpl_default_standup",
        "name": "Standup Recap",
        "description": "Organized by participant with yesterday, today, and blockers sections.",
        "type": "built_in",
        "section_count": 3,
        "created_at": "2026-01-01T00:00:00Z",
        "updated_at": "2026-01-01T00:00:00Z"
      }
    ],
    "pagination": {
      "total": 3,
      "limit": 20,
      "offset": 0,
      "has_more": false
    }
  }
  ```
</ResponseExample>