Skip to main content

​
GET /api/v1/predictions/

Get predictive analytics including score forecasts, goal tracking, and study recommendations.

​
Request

​
required
Unique identifier for the student

​
Query Parameters

​
Headers

​
Response

​
current_math
integer
Current SAT Math score
​
current_rw
integer
Current Reading/Writing score
​
current_total
integer
Current total SAT score
​
predicted_math_in_30_days
integer
Predicted Math score in 30 days
​
predicted_rw_in_30_days
integer
Predicted Reading/Writing score in 30 days
​
predicted_total_in_30_days
integer
Predicted total score in 30 days
​
confidence_intervals
object
​
math
object
​
low
integer
Lower bound
​
high
integer
Upper bound
​
rw
object
…
​
total
object
…
​
goal_tracking
object
​
target_score
integer
Goal score
​
days_to_goal
integer
Estimated days to reach goal
​
progress_percent
float
Current progress as percentage
​
on_track
boolean
Whether trajectory reaches goal

​
Example Request

predictions = await engine.get_predictions("student_123")

​
Example Response

{
  "success": true,
  "data": {
    "current_math": 620,
    "current_rw": 580,
    "current_total": 1200,
    "predicted_math_in_30_days": 680,
    "predicted_rw_in_30_days": 640,
    "predicted_total_in_30_days": 1320,
    "confidence_intervals": {
      "math": {"low": 660, "high": 700},
      "rw": {"low": 620, "high": 660},
      "total": {"low": 1290, "high": 1350}
    },
    "goal_tracking": {
      "target_score": 1400,
      "days_to_goal": 45,
      "progress_percent": 75,
      "on_track": true
    },
    "recommendations": [
      "Focus on Reading/Writing fundamentals",
      "Increase practice frequency by 20%"
    ]
  }
}

​
Status Codes