🚀 English Mentorship Platform

Interactive API Documentation

● API Online
💡 Tip: Click on any endpoint to expand it, fill in the parameters, and click "Try it out!" to see the response.

🔐 Authentication

POST /api/auth/register
Public Access
Description

Register a new user account (MENTEE, MENTOR, or PROVIDER)

Request Body (JSON)
POST /api/auth/login
Public Access
Description

Login with email and password to get JWT token

Request Body (JSON)
GET /api/auth/me
🔒 Auth Required
Description

Get current authenticated user profile

Authorization Header

🏥 Health Check

GET /health
Public Access
Description

Check if API server is running and healthy

💳 Subscriptions

GET /api/subscriptions/plans
Public Access
Description

Get all available subscription plans with pricing

GET /api/subscriptions/my-subscription
🔒 Auth Required
Description

Get my active subscription details

Authorization Header

👨‍🏫 Mentors

GET /api/mentors
Public Access
Description

Search and filter available mentors

Query Parameters (Optional)

💰 Pricing

GET /api/pricing/currencies
Public Access
Description

Get supported currencies and exchange rates

💬 Session Feedback

POST /api/feedbacks
🔒 Mentor Only
Description

Mentor submits feedback for a completed booking (must be submitted within 24 hours)

Authorization Header
Request Body (JSON)
GET /api/feedbacks/received/list
🔒 Mentee Only
Description

Mentee gets all received feedbacks from mentors

Authorization Header
Query Parameters
GET /api/feedbacks/pending/list
🔒 Mentor Only
Description

Mentor gets pending feedbacks (completed bookings without feedback, shows deadline and overdue status)

Authorization Header
GET /api/feedbacks/stats/summary
👑 Admin Only
Description

Get feedback statistics (total, average rating, on-time rate, top mentors, etc.)

Authorization Header

📊 Analytics (Admin Only)

GET /api/analytics/revenue
👑 Admin Only
Description

Get revenue analytics for a date range

Authorization Header
Query Parameters