# List Analytics Templates

Browse ready-made Analytics pages and bundles you can install: your organization's, ones shared with it, and MindCloud's public library. Pick one, check what it needs with Get Analytics Template Install Plan, then install it.

`GET https://connect.mindcloud.co/v2/analytics/templates`

Permissions: `analytics:page:view`.

## Parameters

### Headers

- `X-Company-Id` (string): Optional. The id of the organization to act in. Leave it out to act in the API key's own organization. Here a key acts in another organization only as one of its members: with "Use this key across all of your organizations" on, in an organization its creator belongs to with a role. Child organizations and MindCloud staff access do not reach this endpoint. Every response's X-Company-Id header names the organization it acted in. See [Organizations](https://mindcloud.co/docs/api/rest/introduction/organizations).

### Query

- `q` (string): Search template names and descriptions, as the Templates page does. Plain words; no wildcards.
  The library's own search over template names and descriptions: plain words, no wildcards (unlike name[contains], where * is one).
- `app` (string): Only templates reading this app, by id or slug.
  Only templates reading this app, by its id or slug, from List Universal Apps.
- `tag` (string): Only templates with this topic tag.
  Only templates carrying this topic tag.

## Example request

```bash
curl --request GET \
  --url 'https://connect.mindcloud.co/v2/analytics/templates?q=shopify%20sales&app=shopify&tag=sales' \
  --header 'Authorization: Bearer $MINDCLOUD_API_TOKEN'
```

## Response fields

- `id` (string): Unique id of the template.
- `kind` (string): page for one ready-made page; bundle for several pages installed together into a new folder.
  Allowed values:
    - `page`
    - `bundle`
- `name` (string): The template name.
- `description` (string): What the template shows.
- `library` (string): Where the template comes from: organization (made in your organization), shared (shared with your organization by another one), or public (MindCloud's public library).
  Allowed values:
    - `organization`
    - `shared`
    - `public`
- `publisher` (string): Who offers it: the organization that shared it, or its author.
- `isOfficial` (boolean): Whether MindCloud made and maintains it.
- `tags` (array of string): Topic tags. Filter by one with the tag parameter.
- `appIds` (array of string): The apps its data sources read, by id (List Universal Apps). Filter by one with the app parameter. Install Analytics Template takes a connection for each.
- `installCount` (number): How many times it has been installed.
- `canInstall` (boolean): Whether you can install it.
- `members` (array of objects): For a bundle, the templates in it; empty for a page template.
  - `id` (string): The member template id.
  - `name` (string): The member template name.
  - `appIds` (array): The apps its data sources read.
  - `canInstall` (boolean): Whether you can install this member.
- `publishedOn` (date): When it was published.