NAPLAN
NAPLAN practice across all four domains — Numeracy, Reading, Conventions (MCQ, auto-marked) and Writing (typed response, rubric-marked). Requires the naplan_api app.
Questions are drawn from our calibrated item pool, so selection is synchronous — create returns the question set immediately, with answer keys (you’re a trusted tenant; you run delivery). You then have two journeys off the same attempt:
- Questions only — render and mark/analyse the set yourself. Never submit.
- Questions + diagnosis — submit the student’s responses; we mark and produce the diagnostic. Marking is asynchronous — await the
naplan.completedwebhook or poll the attempt.
Adaptive multistage is opt-in (adaptive: true): each submit that isn’t the final stage returns the next stage’s questions synchronously (difficulty routed from the prior stage).
Every attempt is linked to one of your students via the root user_id (your own identifier), exactly like the rest of the API.
Endpoints
- List skills —
GET /api/v1/naplan/skills - Create an attempt · Submit & retrieve — MCQ domains
- Writing attempt —
POST/PATCH /api/v1/naplan/writing_attempts
Year levels are 3, 5, 7, 9. Domains for /attempts are numeracy, reading, conventions; Writing has its own endpoint.