Cohorts

Read your team's cohorts and who is in them.

Scopecohorts:read

Data requests act inside the key’s centre as the person who created the key: each needs the scope and that person’s current EduMark permission. See auth and pagination.

List cohorts

GET/v1/cohorts

Scope cohorts:read

Parameters

List cohorts: parameters
Field	Details
`limit`	integerItems per page, 1 to 100.1 to 100Default `25`
`cursor`	string, optionalThe `next_cursor` from the previous page.Up to 512 characters
`updated_since`	string, optional
`search`	string, optionalUp to 100 characters

Headers

List cohorts: headers
Field	Details
`EduMark-Version`	enumAPI version. Defaults to the latest.One of `2026-10-21`

Responses

Status	Meaning
200	Successful Response
400	Request rejected. Inspect error.code and request_id; failed work is not billed.
401	Request rejected. Inspect error.code and request_id; failed work is not billed.
403	Request rejected. Inspect error.code and request_id; failed work is not billed.
404	Request rejected. Inspect error.code and request_id; failed work is not billed.
409	Request rejected. Inspect error.code and request_id; failed work is not billed.
410	Request rejected. Inspect error.code and request_id; failed work is not billed.
413	Request rejected. Inspect error.code and request_id; failed work is not billed.
415	Request rejected. Inspect error.code and request_id; failed work is not billed.
422	Validation Error
429	Request rejected. Inspect error.code and request_id; failed work is not billed.
503	Request rejected. Inspect error.code and request_id; failed work is not billed.

Get a cohort

GET/v1/cohorts/{cohort_id}

Scope cohorts:read

Parameters

Get a cohort: parameters
Field	Details
`cohort_id`	stringRequired

Headers

Get a cohort: headers
Field	Details
`EduMark-Version`	enumAPI version. Defaults to the latest.One of `2026-10-21`

Responses

Status	Meaning
200	Successful Response
400	Request rejected. Inspect error.code and request_id; failed work is not billed.
401	Request rejected. Inspect error.code and request_id; failed work is not billed.
403	Request rejected. Inspect error.code and request_id; failed work is not billed.
404	Request rejected. Inspect error.code and request_id; failed work is not billed.
409	Request rejected. Inspect error.code and request_id; failed work is not billed.
410	Request rejected. Inspect error.code and request_id; failed work is not billed.
413	Request rejected. Inspect error.code and request_id; failed work is not billed.
415	Request rejected. Inspect error.code and request_id; failed work is not billed.
422	Validation Error
429	Request rejected. Inspect error.code and request_id; failed work is not billed.
503	Request rejected. Inspect error.code and request_id; failed work is not billed.

Request

curl 'https://api.edumark.ai/v1/cohorts/cohort_123' \
  -H "Authorization: Bearer $EDUMARK_API_KEY"

Response 200JSON

{
  "academic_year": "2026/27",
  "code": "Y10-BIO",
  "created_at": "2026-09-01T09:00:00Z",
  "ends_on": "2027-07-16",
  "id": "cohort_6b1f2c3d4e5f",
  "learner_count": 28,
  "name": "Year 10 Biology",
  "starts_on": "2026-09-08",
  "status": "active",
  "updated_at": "2026-09-01T09:00:00Z"
}

List a cohort's learners

GET/v1/cohorts/{cohort_id}/learners

Scope cohorts:read

Parameters

List a cohort's learners: parameters
Field	Details
`cohort_id`	stringRequired
`limit`	integerItems per page, 1 to 100.1 to 100Default `25`
`cursor`	string, optionalThe `next_cursor` from the previous page.Up to 512 characters

Headers

List a cohort's learners: headers
Field	Details
`EduMark-Version`	enumAPI version. Defaults to the latest.One of `2026-10-21`

Responses

Status	Meaning
200	Successful Response
400	Request rejected. Inspect error.code and request_id; failed work is not billed.
401	Request rejected. Inspect error.code and request_id; failed work is not billed.
403	Request rejected. Inspect error.code and request_id; failed work is not billed.
404	Request rejected. Inspect error.code and request_id; failed work is not billed.
409	Request rejected. Inspect error.code and request_id; failed work is not billed.
410	Request rejected. Inspect error.code and request_id; failed work is not billed.
413	Request rejected. Inspect error.code and request_id; failed work is not billed.
415	Request rejected. Inspect error.code and request_id; failed work is not billed.
422	Validation Error
429	Request rejected. Inspect error.code and request_id; failed work is not billed.
503	Request rejected. Inspect error.code and request_id; failed work is not billed.