Get a result

Question-wise marks, criteria, feedback and totals for one submission. Marks are drafts until you finalize. extracted_answer (what the AI read) is included by default; add include=annotations,model_answer for more.

Scope: evaluation:read

GET /submissions/{submissionId}/result

Get a result

cURL

curl --request GET \
  --url https://api.evalezy.com/v1/submissions/{submissionId}/result \
  --header 'X-API-Key: <api-key>'

200

{
  "submission_id": "9b2e4f71-5c3a-4d8e-b6f0-1a7c3e5d9b24",
  "exam_id": "3f6c1d2e-8b4a-4c7e-9a51-2d0e7b9c4f18",
  "candidate": {
    "id": "c41a7e93-2f58-4b6d-8e0a-5d9f1b3c7e62",
    "external_id": "STU-10A-0142",
    "name": "Aarav Sharma",
    "roll_number": "14"
  },
  "status": "graded",
  "needs_review": false,
  "review_reasons": [],
  "finalized": false,
  "finalized_at": null,
  "rubric_version": 1,
  "totals": {
    "awarded": 3,
    "max": 4,
    "percentage": 75,
    "questions_graded": 2,
    "questions_failed": 0
  },
  "questions": [
    {
      "question_id": "b2e1d3c5-7f9a-4b4d-8e6f-0a2c3d4e5f6a",
      "label": "Q24",
      "section": "C",
      "status": "graded",
      "counted": true,
      "awarded": 2,
      "max": 3,
      "source": "ai",
      "confidence": 0.86,
      "needs_review": false,
      "review_reasons": [],
      "extracted_answer": "In the stomach HCl makes the medium acidic and kills germs. Pepsin breaks proteins...",
      "feedback": "Correctly explains the role of HCl and names pepsin. Does not mention mucus protecting the stomach lining.",
      "criteria": [
        {
          "name": "Role of hydrochloric acid",
          "awarded": 1,
          "max": 1,
          "reason": "Acidic medium and germ-killing stated."
        },
        {
          "name": "Enzymes named",
          "awarded": 1,
          "max": 1,
          "reason": "Pepsin named with its function."
        },
        {
          "name": "Mucus and protection",
          "awarded": 0,
          "max": 1,
          "reason": "Not mentioned."
        }
      ],
      "error": null
    }
  ],
  "checked_copy": {
    "available": true,
    "download_path": "/submissions/9b2e4f71-5c3a-4d8e-b6f0-1a7c3e5d9b24/checked-copy"
  },
  "graded_at": "2026-10-14T06:03:18Z",
  "credits_charged": 12,
  "error": null
}

Authorizations

X-API-Key · string · header · required

Your institute's API key, vak_eval_ followed by 48 hex characters. An institute admin creates keys in the dashboard under Settings -> Integrations -> API keys.

Path Parameters

submissionId · string<uuid> · required

Submission id (UUID).

Query Parameters

include · string

Comma-separated: annotations, model_answer. extracted_answer is included by default; -extracted_answer leaves it out.

Example:

"model_answer"

Response

200

application/json

OK

submission_id · string<uuid>

exam_id · string<uuid>

candidate · object

Show child attributes

status · string

needs_review · boolean

review_reasons · string[]

finalized · boolean

finalized_at · string<date-time> | null

rubric_version · integer | null

totals · object

Show child attributes

questions · object[]

Show child attributes

checked_copy · object

Show child attributes

graded_at · string<date-time> | null

credits_charged · number | null

error · object | null