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

import requests

url = "https://api.evalezy.com/v1/submissions/{submissionId}/result"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.evalezy.com/v1/submissions/{submissionId}/result', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "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
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "The API key is not valid.",
    "request_id": "req_4f9c2a7e1b3d4c8a9e6f0b2d5a7c1e3f"
  }
}

{
  "error": {
    "code": "insufficient_scope",
    "message": "This API key lacks the evaluation:write scope.",
    "request_id": "req_4f9c2a7e1b3d4c8a9e6f0b2d5a7c1e3f",
    "details": {
      "required_scope": "evaluation:write"
    }
  }
}

{
  "error": {
    "code": "not_found",
    "message": "The resource was not found.",
    "request_id": "req_4f9c2a7e1b3d4c8a9e6f0b2d5a7c1e3f"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Retry after 2 s.",
    "request_id": "req_4f9c2a7e1b3d4c8a9e6f0b2d5a7c1e3f"
  }
}