---
title: "Get analytics chart metadata"
method: GET
path: "/analytics/charts/{chart_code}/meta"
tags: ["Analytics"]
---

# Get analytics chart metadata

`GET /analytics/charts/{chart_code}/meta`

Returns the chart's display metadata: available filter attributes and their
concrete values (pre-scoped to the project), available segmentation dimensions,
supported time units, and chart types. Use this to build a UI / discover the
`filter[<attribute>][]` and `segmentation` values for
`GET /v4/analytics/charts/{chart_code}`.

## Path parameters

- `chart_code` 'proceeds' | 'active-subscriptions' | 'paid-subscriptions-movement' | 'users-overview' | 'free-trials' | 'active-trials' | 'trials-movement' | 'user-to-trial' | 'trial-to-paid' | 'user-to-paid' | 'sales' | 'refunds' | 'refund-rate' | 'arppu' | 'arpu' | 'trial-cancellation' | 'subscription-cancellation' | 'subscriptions-overview' | 'new-subscriptions' | 'mrr' | 'arr' | 'mrr-movement' | 'arr-movement' | 'user-to-trial-conversion' | 'subscription-cancellation-rate', required

## Query parameters

- `from` integer
- `to` integer
- `environment` 0 | 1

## Response `200`

Chart metadata.

- V4AnalyticsChartMeta
  - `object` 'analytics_chart_meta', required
  - `url` string, required
  - `code` string, required
  - `title` string, required
  - `description` string
  - `docUrl` string — Link to the narrative documentation for this chart.
  - `isAvailable` boolean, required — False when the chart is blocked by the project's plan or feature flag.
  - `availabilityMessage` string — Human-readable reason the chart is unavailable. Empty when `isAvailable=true`.
  - `type_default` string — Recommended visual type (e.g. `column`).
  - `types` string[]
  - `units_available` string[], required
  - `segmentations` V4AnalyticsSegmentation[], required
    - `code` string, required
    - `label` string, required
    - `category` string
  - `filter_conditions` V4AnalyticsFilterCondition[], required
    - `attribute` string, required — Filter attribute code — use as `filter[<attribute>][]` query key.
    - `category` string — Optional UI grouping (`Device`, `Customer / ID`, `Experiment`, `Attribution`).
    - `label` string, required
    - `type` 'list' | 'text', required — * `list` — value must be one of `values[].code`; supports multi-select when `multiple=true`. * `text` — free-form single value (e.g. `user_id`, `device_id`, `q_user_id`).
    - `multiple` boolean
    - `persistent` boolean — Hint to the UI that this filter should always be visible.
    - `values` object[] — Allowed values for `list`-type filters.
      - `code` string, required
      - `label` string, required

## Other responses

- `400` — Invalid request parameters
- `401` — Unauthorized
- `403` — Insufficient permissions
- `404` — Chart not found
- `429` — Too many requests
- `500` — Internal error
- `502` — Upstream service failure
- `504` — Upstream timeout

---

[API](https://skmtc.net/qonversion/apis/qonversion-rest-api-v4.md) · [All operations](https://skmtc.net/qonversion/apis/qonversion-rest-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qonversion/qonversion-rest-api-v4/versions/e3f72cf8951c/schema)