# List Analytics Folders

See the folders in your Analytics sidebar: your pages and reports, and the pages others shared with you, organized as you filed them. Use a folder's id to file a page into it, give its pages a theme, pause it or share it.

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

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).

## Example request

```bash
curl --request GET \
  --url 'https://connect.mindcloud.co/v2/analytics/folders' \
  --header 'Authorization: Bearer $MINDCLOUD_API_TOKEN'
```

## Response fields

- `id` (string): Unique id of the folder.
- `position` (number): Its place in the sidebar, from 0: sort by it to read the folders in the order the sidebar shows them.
- `name` (string): The folder name, as the Analytics sidebar shows it.
- `section` (string): Which part of the sidebar the folder is in: pages and reports hold your own pages and reports; sharedWithMe organizes pages other people shared with you.
  Allowed values:
    - `pages`
    - `reports`
    - `sharedWithMe`
- `parentFolderId` (string): The folder this one is inside (from List Analytics Folders), or null at the top of its section.
- `themeId` (string): The theme every page in the folder wears unless the page picks its own: a theme id from List Analytics Themes, "cirra" for the plain Cirra look, or null to follow the organization default.
- `isPaused` (boolean): Whether the folder is paused: its pages stop refreshing their data until it is resumed.
- `pausedOn` (date): When the folder was paused, or null.
- `hasShares` (boolean): Whether the folder is shared with anyone (List Analytics Folder Shares).
- `createdOn` (date): When the folder was created.
- `updatedOn` (date): When the folder was last changed.