---
title: "Get cohort analytics metadata"
method: GET
path: "/analytics/cohorts/meta"
tags: ["Analytics"]
---

# Get cohort analytics metadata

`GET /analytics/cohorts/meta`

Returns the discrete value sets needed to build a cohort query: available
`mode`s, `grouping`s, `metric`s, `cohort_definition`s, and filter attributes
with their concrete values (pre-scoped to the project).

## Query parameters

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

## Response `200`

Cohort metadata.

- V4AnalyticsCohortsMeta
  - `object` 'analytics_cohorts_meta', required
  - `url` string, required
  - `modes` object[], required
    - `code` 'by_renewals' | 'by_days'
    - `label` string
  - `groupings` object[], required
    - `code` 'day' | 'week' | 'month' | 'quarter' | 'year'
    - `label` string
  - `metrics` object[], required — Allowed `metric` values. (Metric selection is chosen client-side — the endpoint returns all five.)
    - `code` 'revenue' | 'subscriptions' | 'payers' | 'arpu' | 'arppu'
    - `label` string
  - `definitions` object[], required
    - `code` 'new_customers' | 'initial_conversions' | 'new_paying'
    - `label` 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` — 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)