GET /api/v1/exams/papers/:id

Retrieve an exam

Fetches an exam paper. While generating, status is pending/generating and questions is empty. Once ready, the structured questions, all three documents, and the assessment_id for marking are returned.

Parameters

Name	Type	Required	Description
`delivery`	string	optional	Document format: `pdf` (default) or `html`

Returns

The paper with status, assessment_id, total_marks, questions, a documents object (student_paper, writing_booklet, solutions), and a marking block describing the Mark handoff.

cURL

curl "https://ai.intu.com.au/api/v1/exams/papers/f0a1b2c3-...?delivery=pdf" \
  -H "Authorization: Token token=sk_intu_api_<your_api_key>"

Response

{
  "paper_id": "f0a1b2c3-...",
  "status": "ready",
  "assessment_id": "9c8b7a6d-...",
  "total_marks": 50,
  "questions": [
    { "position": 1, "section": "mcq", "marks": 1, "question_text": "Which is an enzyme?", "mcq_options": { "A": "Amylase", "B": "Glucose" } },
    { "position": 6, "section": "short_answer", "marks": 3, "question_text": "Define homeostasis." }
  ],
  "documents": {
    "delivery": "pdf",
    "student_paper": "https://.../student_paper.pdf?signed=...",
    "writing_booklet": "https://.../writing_booklet.pdf?signed=...",
    "solutions": "https://.../solutions.pdf?signed=..."
  },
  "marking": {
    "assessment_id": "9c8b7a6d-...",
    "instructions": "Submit a student's completed paper to POST /api/v1/mark/submissions with this assessment_id."
  }
}