Skip to main content

cohorts.list

List an organization's cohorts

Request
GET/api/v1/organizations/{organizationSlug}/cohorts
Scope required
organizations:read
Effect
Reads only. Safe to retry and safe for an agent to call unprompted.
Acts on
Acts on an organization, and names it in the path.
MCP tool
cohorts_list
Environment
Live and sandbox alike.
Request body
JSON.

What it does

Returns the cohorts an organization groups its applicants into — an intake, a class, a programme — open ones first and then archived ones, alphabetical within each. Archived cohorts are left out unless you ask for them with `includeArchived=true`. Every cohort carries both of its sizes: how many applicants are in it now, and how many have been through it. An organization keeps few enough cohorts that the whole list comes back in one page. Open a new cohort with `cohorts.create`.

Parameters

Parameters this endpoint accepts, where each one goes, and whether it is required
NameSent inRequirementAccepts
organizationSlugpathRequiredstring
includeArchivedqueryOptionalstring

Response

data
array of object, required
archivedAt
string or null, required
createdAt
string, required
currentMemberCount
integer, required
formerMemberCount
integer, required
id
string, required
name
string, required
hasMore
boolean, required
nextCursor
string or null, required

Examples

The intakes currently taking applicants

The intakes currently taking applicants — request
curl -s https://www.jobapplicationtracking.com/api/v1/organizations/northside-career-center/cohorts \
  -H "Authorization: Bearer $JAT_KEY"
The intakes currently taking applicants — response
{
  "data": [
    {
      "id": "coh_12",
      "name": "Spring 2026 intake",
      "archivedAt": null,
      "createdAt": "2026-01-06T12:00:00.000Z",
      "currentMemberCount": 18,
      "formerMemberCount": 4
    }
  ],
  "hasMore": false,
  "nextCursor": null
}

Related operations