Cohorts

Get Cohorts

GET /api/v2/analyses/reference/cohorts/get-cohorts

Completed cohorts owned by your company. Flat list of { value, text } pairs where value is the cohort id, most recent first. Scoped strictly to your company, so no other company’s cohorts are returned. To create a cohort from a file in your own cloud storage - and to poll one that is still processing - use the Cohorts surface.

Auth: bearer token + Accept: application/json. Rate limit: read bucket (120 requests/min).

Query parameters

Field	Type	Required	Description
`search`	string	No	Optional free-text filter on the cohort name (case-insensitive contains).

curl "https://console.intuizi.com/api/v2/analyses/reference/cohorts/get-cohorts" \
  -H "Authorization: Bearer <YOUR_TOKEN>" \
  -H "Accept: application/json"

import requests

res = requests.get(
    "https://console.intuizi.com/api/v2/analyses/reference/cohorts/get-cohorts",
    headers={"Authorization": "Bearer <YOUR_TOKEN>", "Accept": "application/json"},
)
cohorts = res.json()["data"]

const res = await fetch(
  "https://console.intuizi.com/api/v2/analyses/reference/cohorts/get-cohorts",
  { headers: { Authorization: "Bearer <YOUR_TOKEN>", Accept: "application/json" } }
);
const cohorts = (await res.json()).data;

Response

{
  "status": "success",
  "code": 200,
  "message": "Resources fetched successfully.",
  "data": [
    { "value": 51, "text": "Q1 Loyalty Cohort" }
  ]
}

Failed requests use the shared error envelope - see Errors.

Pass a cohort value as the cohort_id in the Audiences Cohorts dataset create body.

Apps POI