Injury Surveillance System - API Endpoints

Backend REST API Structure | Neo4j + NestJS

32
Total Endpoints
7
MVP Required
~35
Estimated Hours
= Sample endpoint (detailed in docs)
MVP Must have (Weeks 3-5)
Phase 2 Should have (Week 6)
Phase 3 Nice to have
/api
/auth - Authentication & Authorization
POST
/register
MVP
Create new user account
POST
/login
MVP
Authenticate user and return JWT
POST
/logout
Phase 2
Invalidate refresh token
POST
/refresh-token
MVP
Get new access token
POST
/forgot-password
Phase 3
Request password reset
/players - Player Management
GET
/:playerId
MVP
Get player profile
PATCH
/:playerId
Phase 2
Update player profile
PATCH
/:playerId/status
MVP
Update daily status (GREEN/ORANGE/RED) ★ SAMPLE
GET
/:playerId/injuries
Phase 2
Get injury history
GET
/:playerId/teams
Phase 2
Get all teams player belongs to
DELETE
/:playerId
Phase 3
Delete player account (GDPR)
/coaches - Coach Operations
GET
/:coachId
MVP
Get coach profile
GET
/teams
Phase 2
Get all teams managed by coach
GET
/teams/:teamId/players
MVP
Get team roster with status ★ SAMPLE
GET
/teams/:teamId/analytics
Phase 3
Get injury analytics for team
GET
/dashboard
Phase 2
Get aggregated coach dashboard data
/injuries - Injury Reporting & Tracking
POST
/
MVP
Report new injury ★ SAMPLE
GET
/:injuryId
MVP
Get injury details
PATCH
/:injuryId
Phase 2
Update injury details
POST
/:injuryId/recovery-update
Phase 3
Add recovery progress note
POST
/:injuryId/resolve
Phase 2
Mark injury as resolved
/teams - Team Management
GET
/
Phase 2
List all teams (admin)
POST
/
Phase 3
Create new team (admin)
GET
/:teamId
MVP
Get team details
PATCH
/:teamId
Phase 3
Update team details
POST
/:teamId/players/:playerId
Phase 3
Add player to team
DELETE
/:teamId/players/:playerId
Phase 3
Remove player from team
/notifications - Push Notifications
POST
/token
MVP
Register FCM device token
GET
/
Phase 2
Get user notifications
PATCH
/:notificationId/read
Phase 2
Mark notification as read
/admin - System Administration
GET
/users
Phase 3
List all users
POST
/organizations
Phase 3
Create new organization
GET
/analytics/system-wide
Phase 3
Get anonymized system analytics
POST
/invite
Phase 3
Send invitation to new organization