Tutor Endpoints

Current API

Get tutor (internal)

GET /api/tutors/{id}

Auth: auth:api + internal Returns full tutor data for admin use.

Get tutor profile (public)

GET /api/tutors/{id}/profile

Auth: None Returns public-facing tutor profile via TutorProfileTransformer:

Basic info: name, username, joined date, profile picture, video, bio
Verification status, visibility
Location, education, languages
Tutoring/teaching experience
Overall rating, social links

Get tutor reviews

GET /api/tutors/{id}/review

Auth: web.api Returns review summary via TutorReviewService::getReviewSummary() (cached until end of day).

Submit tutor review

POST /api/tutors/{id}/review

Auth: web.api Creates a review with rating criteria and optional comment (max 300 chars).

Legacy v1 API

Get tutor status

GET /api/v1/tutors/status

Auth: auth:api Returns current tutor’s verification and profile status.

Teaches (subjects taught)

GET    /api/v1/teaches
POST   /api/v1/teaches
PUT    /api/v1/teaches/{id}
DELETE /api/v1/teaches/{id}

Auth: auth:api Manages tutor’s taught subjects. Each Teach includes:

Subject
Subject levels (via taught_subject_levels pivot)
Exam boards (via taught_exam_boards pivot)
Lesson price (hourly rate)

Additional actions:

PUT /api/v1/teaches/{id}/enable    — Enable teach
PUT /api/v1/teaches/{id}/disable   — Disable teach

Current API teaches

GET /api/teaches

Auth: None — returns available teaches (public).

Verification - Identity

POST /api/v1/verification/identity

Auth: auth:api Submits identity verification via Onfido/Yoti.

Verification - Qualification

POST /api/v1/verification/qualification

Auth: auth:api Uploads qualification document.

Verification - DBS

POST /api/v1/verification/dbs

Auth: auth:api Uploads DBS certificate document.

Day availabilities

GET    /api/v1/day-availabilities
POST   /api/v1/day-availabilities
PUT    /api/v1/day-availabilities/{id}
DELETE /api/v1/day-availabilities/{id}

Auth: auth:api Manages weekly availability schedule. Each day availability includes:

Day of week
Time slots (from/to)
Lesson types (online, tutor’s home, student’s home)
Optional subject/level/exam board filters

Locations

GET    /api/v1/locations
POST   /api/v1/locations
PUT    /api/v1/locations/{id}
DELETE /api/v1/locations/{id}

Auth: auth:api Manages tutor’s location (postcode, lat/lng, max travel distance).

GET    /api/social-links
POST   /api/social-links
PUT    /api/social-links/{id}
DELETE /api/social-links/{id}

Auth: Mixed (some require auth:api). Manages social platform links (Twitter, LinkedIn, etc.) via SocialPlatformLink model.

​Current API

​Get tutor (internal)

​Get tutor profile (public)

​Get tutor reviews

​Submit tutor review

​Legacy v1 API

​Get tutor status

​Teaches (subjects taught)

​Current API teaches

​Verification - Identity

​Verification - Qualification

​Verification - DBS

​Day availabilities

​Locations

​Social links