Tests

List every student's result for a test

One page of student results for a test, in the same shape as GET /v1/tests/{test_id}/results/{student_ref}.

Only students with an attempt on the test appear here — someone never assigned or who never started has no attempt and so no row, same as the single-student endpoint's 404 for a student with no attempt.

Narrow with status (NOT_STARTED, QUEUED, UNDER_EVALUATION, EVALUATED, FAILED, DISPUTED). Page with page and size; keep going while pagination.has_next_page is true.

Returns 404 if the test doesn't exist or belongs to another organisation.

get/v1/tests/{test_id}/results

Request

  • Base URL: https://api.acadine.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.acadine.ai/v1/tests/{test_id}/results
  • Auth: API key in header X-API-Key

Path parameters

test_idstring required

Query parameters

status'NOT_STARTED' | 'QUEUED' | 'UNDER_EVALUATION' | 'EVALUATED' | 'FAILED' | 'DISPUTED'

Mirrors the internal TestEvaluationStatus one-for-one.

Restrict to one evaluation status.

pageinteger
sizeinteger

Response

Successful Response

Example response

{
  "results": [
    {
      "answer_sheet_ref": "TAS_5c1e77b9",
      "test_id": "TST_2f8a91c4",
      "student_ref": "a7f3-9c21",
      "marks_obtained": 72,
      "total_marks": 100
    }
  ],
  "pagination": {
    "page": 1,
    "size": 50,
    "total_count": 137,
    "total_pages": 3
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.