Graduates

Track and manage student graduation records.

All endpoints require Authorization: Bearer <token>. X-SCHOOL-ID is required for listing graduates.

---

List Graduates

GET /graduates

Returns a paginated list of graduates for the current school.

Query Parameters

Parameter	Type	Required	Default	Description
page	integer	Yes	0	Zero-indexed page
size	integer	Yes	50	Results per page

Example

curl -X GET "https://api.vanillatots.com/graduates?page=0&size=25" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-SCHOOL-ID: $SCHOOL_ID"

Response 200 OK

[
  {
    "id": 1,
    "student": 42,
    "graduation_class": "JSS 3A - 2024",
    "school": "Sunrise Academy"
  }
]

---

Create Graduate

POST /graduates

Record a student as a graduate.

Request Body

Field	Type	Required	Description
student	uuid	Yes	Student ID

Example

curl -X POST https://api.vanillatots.com/graduates \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "student": "student-uuid" }'

Response 200 OK — Returns the created GraduateResponse.