List Cohorts

GET /smart-ia/cohorts

Returns a paginated list of Smart IA Cohorts

Query parameters

  • academicYearId string(uuid) | string
  • limit integer(int32)

    Specify the pagination limit, defaults to 100

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

  • offset integer(int32)

    Specify the pagination offset, defaults to 0.

    Cannot be used with cursor

    Default value is 0.

  • 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
    • pagination object Required
      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 \
 -X GET https://connect.century.tech/api/v1/smart-ia/cohorts
Response examples (200)
{
  "data": [
    {
      "name": "Cohort 2023",
      "tests": [
        {
          "testId": "c5a77fda-7174-446f-a4f5-0f47ccbf15ce",
          "activationStatus": "active"
        }
      ],
      "cohortId": "784baee5-08ab-459a-ab44-b24a0efd3a57",
      "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="
  }
}