---
title: "List Saved Cohorts"
method: POST
path: "/cohorts/list"
tags: ["Cohorts"]
---

# List Saved Cohorts

`POST /cohorts/list`

The list endpoint returns all of the cohorts in a given project. The JSON formatted return contains the cohort name, id, count, description, creation date, and visibility for every cohort in the project.

If you're trying to get a list of users in a cohort, you can use the [`/engage` endpoint with the `filter_by_cohort` parameter](/reference/engage-query).
The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries.

## Query parameters

- `project_id` integer, required
- `workspace_id` integer

## Response `200`

Success.

- object[]
  - `count` integer
  - `is_visible` integer — 0 if not visible. 1 if visible
  - `description` string
  - `created` string
  - `project_id` integer
  - `id` integer
  - `name` string

---

[API](https://skmtc.net/mixpanel/apis/query-api.md) · [All operations](https://skmtc.net/mixpanel/apis/query-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixpanel/query-api/revisions/f442da95252a/schema)