API Reference
The complete, always-current reference is generated from the OpenAPI spec at
sdks/openapi/mirrormingo.openapi.yaml
and published at https://docs.mirrormingo.com/reference.
To build it locally:
cd sdks && npm install
npx @redocly/cli build-docs openapi/mirrormingo.openapi.yaml -o ../docs/developers/reference.html
Endpoint summary
Base URL: https://api.mirrormingo.com/v1 (sandbox: https://sandbox.api.mirrormingo.com/v1)
This reference covers the public MirrorMingo Exam & Mock API. School Intelligence is not exposed to third-party API keys.
Exams
| Method | Path | Description |
|---|---|---|
| GET | /exam-prep/list | List supported exams |
| GET | /exam-prep/{exam_key}/overview | Sections, timing, scoring |
| GET | /exam-prep/{exam_key}/resources | Verified official sources |
| GET | /exam-prep/{exam_key}/study-path | Recommended study path |
Mock exams
| Method | Path | Description |
|---|---|---|
| GET | /exam-prep/{exam_key}/mock-exams | List past-question papers by year |
| POST | /exam-prep/{exam_key}/mock-exams/open | Open a paper into a timed attempt |
| POST | /exam-prep/{exam_key}/mock-exams/questions | Page through questions |
| POST | /exam-prep/{exam_key}/mock-exams/submit | Submit answers, get scored feedback |
| GET | /exam-prep/{exam_key}/mock-exams/history | List prior attempts |
Exam endpoints require Authorization: Bearer mirrormingo_....
Mock-exam open, question-page, submit and history calls accept optional
learner_id/learnerId namespacing for partner apps with multiple learners.
Each returned question includes answer_id; use that as the key in the
answers object when submitting. Plain question-number keys are accepted for
older clients when unambiguous.