| Method | Path | Request / response | Status |
|---|
| GET | /v3/school/students | q, school_id, status[], class_ids[], level, has_debt, low_balance, consent_zalo, enrolled_from, enrolled_to, sort, page, limit → StudentRow[] (student + primary guardian + balance) | new (bao bọc existing school-finance/students) |
| POST | /v3/school/students | {school_id, display_name, birthday, gender, school_name, grade, level_code, address, health_note, learner: {learner_profile_id} | {create: true}, guardians: [{guardian_id | {full_name, phone, email}, relationship, is_primary_contact, is_payer, consents: [type]}]} → Student | new |
| GET | /v3/school/students/{id} | Student + guardians + enrollments + balance + flags | new |
| PATCH | /v3/school/students/{id} | partial profile | new |
| POST | /v3/school/students/{id}/status | {to: paused|withdrawn|dropped|active, reason, effective_date, expected_return_date?, class_id?} → Student; 409 INVALID_TRANSITION | new |
| POST | /v3/school/students/{id}/transfer | {to_school_id, effective_date, class_id?, note} → {new_student_id} | new |
| GET/POST | /v3/school/students/{id}/guardians | thêm hoặc liên kết phụ huynh; PATCH /v3/school/guardians/{id}; DELETE để xoá liên kết | new |
| GET/POST | /v3/school/guardians?phone= | tra cứu theo số điện thoại để dùng lại | new |
| POST | /v3/school/consents | {guardian_id, student_id?, type, version, channel} ; DELETE để thu hồi | new |
| GET/POST/DELETE | /v3/school/students/{id}/documents | {type, file_id, name} | new |
| GET/POST/PATCH/DELETE | /v3/school/students/{id}/notes | {body, is_flagged, visibility} | new |
| GET | /v3/school/students/{id}/balance | student_balance | new |
| POST | /v3/school/students/{id}/anonymise | {request_ref} | new |
| GET | /v3/teacher/school-finance/students/{id}/stats | /tuitions | /courses | tab học phí | existing |
| GET | /v3/parent/learner/{id}/report, /weekly-report | tab học tập (nhân sự gọi API với quyền xác thực của school) | existing (cần được cấp quyền truy cập cho nhân sự) |
| GET | /v3/teacher/students/quick-search | bộ chọn | existing |
| POST | /v3/school/students/{id}/credentials/resend | gửi thông tin đăng nhập FLYER đến kênh liên hệ của phụ huynh | new |
