GET /api/v1/mark/submissions/:id

Retrieve a submission

Fetches a submission and its marking. Results are progressive: status moves pending → extracting → marking → completed. Once complete, per-question results, totals, and feedback are populated.

Returns

The submission with status, an extraction block (page_count, answers_found/answers_total), and a marking block (percentage, grade, questions_correct/questions_total, results, strengths, weaknesses, improvement_suggestions, topic_performance, usage).

cURL

curl "https://ai.intu.com.au/api/v1/mark/submissions/a3f1b2c4-..." \
  -H "Authorization: Token token=sk_intu_api_<your_api_key>"

Response

{
  "submission_id": "a3f1b2c4-...",
  "status": "completed",
  "extraction": { "status": "extracted", "page_count": 5, "answers_found": 18, "answers_total": 20 },
  "marking": {
    "status": "completed",
    "percentage": 82,
    "grade": "B",
    "questions_correct": 16,
    "questions_total": 20,
    "results": [
      { "question_number": 1, "result_status": "correct", "awarded_marks": 3, "marks_available": 3, "needs_review": false }
    ],
    "strengths": ["Strong on genetic crosses"],
    "weaknesses": ["Mutation types"],
    "usage": { "total_tokens": 4866 }
  }
}