List Cohorts

GET /smart-ia/cohorts

Returns a paginated list of Smart IA Cohorts

Query parameters

  • academicYearId string(uuid) | string

    Filter cohorts by academic year ID or provide current for the current academic year

  • limit integer(int32)

    Specify the pagination limit, defaults to 100

  • offset integer(int32)

    Specify the pagination offset, defaults to 0.

    Cannot be used with cursor

  • cursor string(byte) | null

    Provide the next or previous page cursor

Responses

  • 200 application/json

    A paginated list of cohorts.

    Hide response attributes Show response attributes object
    • data array[object] Required
      Hide data attributes Show data attributes object
      • cohortId string(uuid) Required

        Cohort UUID.

      • name string Required

        The name of the cohort

      • Optional cohort description

      • academicYearId string(uuid) Required

        Academic Year UUID.

      • tests array[object] Required
        Hide tests attributes Show tests attributes object
        • testId string(uuid) Required

          The Smart IA test ID

        • testVersionId string(uuid) Required

          The unique identifier for the Smart IA test version (UUID).

        • name string Required

          The name of the Smart IA test.

        • subject string Required

          The subject of the Smart IA test.

        • activationStatus string Required

          Values are active, inactive, or deactivated.

    • pagination object Required

      Metadata for the current pagination position

      Hide pagination attributes Show pagination attributes object
      • total integer(int32) Required

        The total number of items available.

      • limit integer(int32) Required

        The maximum number of results to return per page.

        Minimum value is 1, maximum value is 100. Default value is 100.

      • offset integer(int32) Required

        Indicates the starting position or index (offset)

        Default value is 0.

      • previousCursor string(byte) | null Required

        The cursor for pagination. Encoded byte string used to navigate between pages.

      • nextCursor string(byte) | null Required

        The cursor for pagination. Encoded byte string used to navigate between pages.

  • Invalid request.

  • Invalid authentication credentials

  • Not authorised to access this resource

GET /smart-ia/cohorts
curl \
 --request GET 'https://connect.century.tech/api/v1/smart-ia/cohorts' \
 --header "x-api-key: $API_KEY"
Response examples (200)
{
  "data": [
    {
      "name": "Cohort 2023",
      "tests": [
        {
          "name": "English Initial Test",
          "testId": "c5a77fda-7174-446f-a4f5-0f47ccbf15ce",
          "subject": "English",
          "testVersionId": "38444333-7450-49d5-922d-eb16a8f30589",
          "activationStatus": "active"
        }
      ],
      "cohortId": "c334f818-0281-4f47-855a-3a3d0e356cfd",
      "description": "This cohort is for students graduating in 2023",
      "academicYearId": "dccd109a-08ca-4a18-a277-4653ba726316"
    }
  ],
  "pagination": {
    "limit": 30,
    "total": 300,
    "offset": 100,
    "nextCursor": "eyJsaW1pdCI6MSxiZWZvcmU6IiIsc29ydDpbWyJlbmREYXRlIiwiZGVzYyJdXX0=",
    "previousCursor": "eyJsaW1pdCI6MSxiZWZvcmU6IiIsc29ydDpbWyJlbmREYXRlIiwiZGVzYyJdXX0="
  }
}