cohort_memberships.list

List every stint applicants have spent in cohorts

Request: GET/api/v1/organizations/{organizationSlug}/cohort-memberships
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: cohort_memberships_list
Environment: Live and sandbox alike.
Request body: JSON.

What it does

Returns one row per stint — one period one applicant spent in one cohort — most recently joined first. Nothing here is ever rewritten: somebody who completed the autumn intake and is now in the spring one has two rows, not a corrected one, and a closed stint keeps its `leftAt` and `departureReason`. Narrow with `applicantEmail`, `cohortId`, or `active=true` for the stints still running. Only current applicant members of the organization are covered. Place somebody in a cohort with `cohort_memberships.create`.

Parameters

Parameters this endpoint accepts, where each one goes, and whether it is required
Name	Sent in	Requirement	Accepts
organizationSlug	path	Required	string
applicantEmail	query	Optional	string or string
cohortId	query	Optional	string
active	query	Optional	string
limit	query	Optional	integer
cursor	query	Optional	string

Response

data

array of object, required

applicantEmail: string, required
cohortId: string, required
departureReason: one of: completed, placed, withdrew, removed or null, required
id: string, required
joinedAt: string, required
leftAt: string or null, required
note: string or null, required

hasMore

boolean, required

nextCursor

string or null, required

Examples

Who is in the spring intake right now

Who is in the spring intake right now — request

curl -s https://www.jobapplicationtracking.com/api/v1/organizations/northside-career-center/cohort-memberships?cohortId=coh_12&active=true \
  -H "Authorization: Bearer $JAT_KEY"

Who is in the spring intake right now — response

{
  "data": [
    {
      "id": "cm_87",
      "cohortId": "coh_12",
      "applicantEmail": "student@northside.example",
      "joinedAt": "2026-01-06T12:00:00.000Z",
      "leftAt": null,
      "departureReason": null,
      "note": null
    }
  ],
  "hasMore": false,
  "nextCursor": null
}