Scoresheets

Retrieve aggregated student scoresheets combining grades across assessments.

All endpoints require Authorization: Bearer <token> and X-SCHOOL-ID headers.

---

Get Scoresheet

GET /scoresheets/{id}/scoresheet

Returns the scoresheet for a cohort subject, showing each student's grades across all assessments.

Path Parameters

Parameter	Type	Description
id	uuid	Cohort subject ID

Query Parameters

Parameter	Type	Required	Description
term	uuid	No	Filter by term ID

Example

curl -X GET "https://api.vanillatots.com/scoresheets/{id}/scoresheet?term=term-uuid" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-SCHOOL-ID: $SCHOOL_ID"

Response 200 OK

[
  {
    "student": {
      "id": "uuid",
      "first_name": "John",
      "last_name": "Doe",
      "admission_number": "STU-001"
    },
    "gradebooks": [
      {
        "id": "uuid",
        "assessment": "uuid",
        "assessment_category": "CA1",
        "score": 18.5,
        "student": "uuid",
        "batch": "uuid",
        "subject": "uuid"
      }
    ]
  }
]