---
title: "Execute a headless cohort"
method: POST
path: "/application/{applicationId}/analytics/v1/cohorts/execute"
tags: ["Cohorts"]
---

# Execute a headless cohort

`POST /application/{applicationId}/analytics/v1/cohorts/execute`

## Path parameters

- `applicationId` number, required

## Headers

- `environment_id` number, required

## Request body

- array[]
  - object[]
    - `operator` 'and' | 'or', required
    - `conditions` union[], required
      - union
        - object
          - `positive` boolean, required
          - `metric` object, required
            - `type` 'cohort', required
            - `name` string, required
            - `definition` unknown, required
            - `unresolved` boolean
            - `filter` object
              - …
        - object
          - `positive` boolean, required
          - `metric` object, required
            - `type` 'event', required
            - `name` string, required
            - `filter` object
              - …
          - `math` object, required
            - `function` 'unique' | 'sum' | 'count' | 'total' | 'average' | 'median' | 'minimum' | 'maximum' | 'percentile' | 'dau' | 'wau' | 'mau' | 'distinct' | 'distinct_count' | 'last' | 'last_value' | 'first' | 'first_value' | 'most_frequent', required
            - `column` object, required
              - …
            - `perSessionAggregation` 'unique' | 'sum' | 'count' | 'total' | 'average' | 'median' | 'minimum' | 'maximum' | 'percentile' | 'dau' | 'wau' | 'mau' | 'distinct' | 'distinct_count' | 'last' | 'last_value' | 'first' | 'first_value' | 'most_frequent'
          - `date` object, required
            - `operation` 'On' | 'Not on' | 'Between' | 'Not between' | 'Before' | 'Since' | 'In the last' | 'Not in the last', required
            - `interval` union, required
              - …

## Response `200`

Default Response

---

[API](https://skmtc.dev/gamebeast/apis/gamebeast-api.md) · [All operations](https://skmtc.dev/gamebeast/apis/gamebeast-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gamebeast/gamebeast-api/revisions/e9940594b0cc/schema)