# List Analytics Themes

See your organization's Analytics themes: fonts, colors, chart and panel styling a page or a folder can wear. Use a theme's id as themeId on a page or a folder, or "cirra" for the plain Cirra look.

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

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/themes' \
  --header 'Authorization: Bearer $MINDCLOUD_API_TOKEN'
```

## Response fields

- `id` (string): Unique id of the theme.
- `name` (string): The theme name.
- `isDefault` (boolean): Whether new pages in the organization start with this theme. When no theme is the default, new pages wear the plain Cirra look.
- `style` (object): The look the theme gives a page, option by option. An option it leaves out keeps the default.
  - `fontFamily` (string): Font family. One of: "Inter, sans-serif" (Inter), ""SF Pro Display", -apple-system, sans-serif" (SF Pro Display), ""Helvetica Neue", Helvetica, sans-serif" (Helvetica Neue), "system-ui, sans-serif" (System UI), ""Segoe UI", sans-serif" (Segoe UI), "Roboto, sans-serif" (Roboto), ""Open Sans", sans-serif" (Open Sans), "Lato, sans-serif" (Lato), ""Source Sans 3", sans-serif" (Source Sans), ""IBM Plex Sans", sans-serif" (IBM Plex Sans), ""Atkinson Hyperlegible", sans-serif" (Atkinson Hyperlegible), "Georgia, "Times New Roman", serif" (Georgia), ""IBM Plex Mono", monospace" (IBM Plex Mono). Absent when the default is used.
    Allowed values:
      - `Inter, sans-serif`
      - `"SF Pro Display", -apple-system, sans-serif`
      - `"Helvetica Neue", Helvetica, sans-serif`
      - `system-ui, sans-serif`
      - `"Segoe UI", sans-serif`
      - `Roboto, sans-serif`
      - `"Open Sans", sans-serif`
      - `Lato, sans-serif`
      - `"Source Sans 3", sans-serif`
      - `"IBM Plex Sans", sans-serif`
      - `"Atkinson Hyperlegible", sans-serif`
      - `Georgia, "Times New Roman", serif`
      - `"IBM Plex Mono", monospace`
  - `fontScale` (string): Font size. One of: "0.9" (Small), "1" (Medium), "1.1" (Large), "1.25" (Extra Large). Absent when the default is used.
    Allowed values:
      - `0.9`
      - `1`
      - `1.1`
      - `1.25`
  - `panelTitleWeight` (string): Panel title weight. One of: "regular" (Regular), "medium" (Medium), "bold" (Bold). Absent when the default is used.
    Allowed values:
      - `regular`
      - `medium`
      - `bold`
  - `pageTitleSize` (string): Page title size. One of: "compact" (Compact), "regular" (Regular), "large" (Large). Absent when the default is used.
    Allowed values:
      - `compact`
      - `regular`
      - `large`
  - `seriesColors` (array): Series colors: light and dark color pairs in the order charts hand colors out; a null entry uses that slot's default. Absent when the defaults are used.
    - `light` (string): The color in light mode, as hex.
    - `dark` (string): The color in dark mode, as hex.
  - `statusColors` (object): Status colors, a light and dark color pair per entry. Absent when the defaults are used.
    - `success` (object): Success, or null for the default.
      - `light` (string): The color in light mode, as hex.
      - `dark` (string): The color in dark mode, as hex.
    - `warning` (object): Warning, or null for the default.
      - `light` (string): The color in light mode, as hex.
      - `dark` (string): The color in dark mode, as hex.
    - `warningBright` (object): Caution, or null for the default.
      - `light` (string): The color in light mode, as hex.
      - `dark` (string): The color in dark mode, as hex.
    - `failure` (object): Failure, or null for the default.
      - `light` (string): The color in light mode, as hex.
      - `dark` (string): The color in dark mode, as hex.
  - `chartGridlines` (string): Chart gridlines. One of: "off" (Off), "dashed" (Dashed), "solid" (Solid). Absent when the default is used.
    Allowed values:
      - `off`
      - `dashed`
      - `solid`
  - `chartAreaFill` (string): Area fill. One of: "none" (None), "light" (Light), "solid" (Solid). Absent when the default is used.
    Allowed values:
      - `none`
      - `light`
      - `solid`
  - `chartCurve` (string): Line curve. One of: "straight" (Straight), "smooth" (Smooth), "natural" (Curved). Absent when the default is used.
    Allowed values:
      - `straight`
      - `smooth`
      - `natural`
  - `chartPoints` (string): Point marks. One of: "shown" (Shown), "hidden" (Hidden). Absent when the default is used.
    Allowed values:
      - `shown`
      - `hidden`
  - `chartValues` (string): Value labels. One of: "shown" (Shown), "hidden" (Hidden). Absent when the default is used.
    Allowed values:
      - `shown`
      - `hidden`
  - `chartLegend` (string): Legend. One of: "auto" (Auto), "shown" (Shown), "hidden" (Hidden). Absent when the default is used.
    Allowed values:
      - `auto`
      - `shown`
      - `hidden`
  - `numberFormat` (string): Number format. One of: "point" (1,234.56), "comma" (1.234,56), "space" (1 234,56). Absent when the default is used.
    Allowed values:
      - `point`
      - `comma`
      - `space`
  - `numberCompact` (string): Compact numbers. One of: "auto" (Auto), "always" (Always), "never" (Never). Absent when the default is used.
    Allowed values:
      - `auto`
      - `always`
      - `never`
  - `dateOrder` (string): Date order. One of: "monthFirst" (Jan 6, 2026), "dayFirst" (6 Jan 2026). Absent when the default is used.
    Allowed values:
      - `monthFirst`
      - `dayFirst`
  - `dateStyle` (string): Date style. One of: "short" (Short), "medium" (Medium), "numeric" (Numeric). Absent when the default is used.
    Allowed values:
      - `short`
      - `medium`
      - `numeric`
  - `panelCorners` (string): Panel corners. One of: "square" (Square), "rounded" (Rounded), "soft" (Soft). Absent when the default is used.
    Allowed values:
      - `square`
      - `rounded`
      - `soft`
  - `panelElevation` (string): Panel elevation. One of: "none" (None), "hairline" (Hairline), "raised" (Raised). Absent when the default is used.
    Allowed values:
      - `none`
      - `hairline`
      - `raised`
  - `panelGap` (string): Panel gap. One of: "none" (None), "tight" (Tight), "regular" (Regular), "wide" (Wide). Absent when the default is used.
    Allowed values:
      - `none`
      - `tight`
      - `regular`
      - `wide`
  - `panelPadding` (string): Panel padding. One of: "compact" (Compact), "regular" (Regular), "comfortable" (Comfortable). Absent when the default is used.
    Allowed values:
      - `compact`
      - `regular`
      - `comfortable`
  - `tableDensity` (string): Table density. One of: "compact" (Compact), "regular" (Regular), "comfortable" (Comfortable). Absent when the default is used.
    Allowed values:
      - `compact`
      - `regular`
      - `comfortable`
  - `pageBackground` (object): Page background, a light and dark color pair per entry. Absent when the defaults are used.
    - `page` (object): Page, or null for the default.
      - `light` (string): The color in light mode, as hex.
      - `dark` (string): The color in dark mode, as hex.
  - `panelFill` (object): Panel fill, a light and dark color pair per entry. Absent when the defaults are used.
    - `panel` (object): Panel, or null for the default.
      - `light` (string): The color in light mode, as hex.
      - `dark` (string): The color in dark mode, as hex.
  - `ink` (object): Ink, a light and dark color pair per entry. Absent when the defaults are used.
    - `ink` (object): Ink, or null for the default.
      - `light` (string): The color in light mode, as hex.
      - `dark` (string): The color in dark mode, as hex.
  - `lineColor` (object): Line color, a light and dark color pair per entry. Absent when the defaults are used.
    - `line` (object): Line, or null for the default.
      - `light` (string): The color in light mode, as hex.
      - `dark` (string): The color in dark mode, as hex.
  - `brandHeaderColor` (object): Publication header color, a light and dark color pair per entry. Absent when the defaults are used.
    - `header` (object): Header, or null for the default.
      - `light` (string): The color in light mode, as hex.
      - `dark` (string): The color in dark mode, as hex.
  - `cirraMark` (string): Cirra mark. One of: "shown" (Shown), "hidden" (Hidden). Absent when the default is used.
    Allowed values:
      - `shown`
      - `hidden`
- `createdOn` (date): When the theme was created.
- `updatedOn` (date): When the theme was last changed.