API Reference
Submit a grade
Submit a new grade for a student in a class.
Authorization
BearerAuth AuthorizationBearer <token>
Obtain your API key from the developer dashboard at https://dashboard.educare.com
In: header
Request Body
application/json
student_id*integer
class_id*integer
assignment_name?string
score*number
Format
floatmax_score?number
Format
floatterm*string
comments?string
Response Body
application/json
application/json
application/json
curl -X POST "https://api.educare.com/v1/grades" \ -H "Content-Type: application/json" \ -d '{ "student_id": 1234, "class_id": 890, "score": 88, "term": "Fall 2025" }'{
"id": 5678,
"student_id": 1234,
"class_id": 890,
"assignment_name": "Midterm Exam",
"score": 92.5,
"max_score": 100,
"letter_grade": "A-",
"term": "Fall 2025",
"graded_at": "2025-11-15T14:30:00Z",
"comments": "Excellent work on the theoretical section"
}{
"error": "Validation failed: email is required",
"code": "VALIDATION_ERROR",
"status": 400
}{
"error": "Invalid API key",
"code": "UNAUTHORIZED",
"status": 401
}