Grades

API endpoints for getting grade data

Get all grades

List all grades

GET https://your-platform-url.com/api/so2/v1/grades

Get all course user grades for your instance

Headers

Name	Type	Description
Access-Control-Request-Headers*	string	authorization
Authorization*	string	Bearer <auth_token>
Content-Type*	string	application/json

200

{"username":"johndoe",
"email":"[email protected]",
"course_id":"course-v1:MOOCit-demo-1",
"display_name": "MOOCit demonstration Course #1",
"percent_grade":"0.80",
"letter_grade":"Pass",
"passed_timestamp":"2020-03-28 23:21:24.354019"
"last_date":"2020-11-26"
}, 
{"username":"JaneDoe",
"email":"[email protected]",
"course_id":"course-v1:MOOCit-demo-2",
"display_name": "MOOCit demonstration Course #2",
"percent_grade":"0.20",
"letter_grade":"",
"passed_timestamp":null
"last_date":"2020-11-26"
}
...

Get grades by course

List grades by course

GET https://your-platform-url.com/api/so2/v1/grades?course_id={course_id}

Get course user grades for a given course

Query Parameters

Name	Type	Description
course_id	string	the course_id course-v1:org+num+session

Headers

Name	Type	Description
Access-Control-Request-Headers*	string	authorization
Authorization*	string	Bearer <auth_token>
Content-Type*	string	application/json

200

{"username":"johndoe",
"email":"[email protected]",
"course_id":"course-v1:MOOCit-demo-1",
"display_name": "MOOCit demonstration Course #1",
"percent_grade":"0.80",
"letter_grade":"Pass",
"passed_timestamp":"2020-03-28 23:21:24.354019"
"last_date":"2020-11-26"
}, 
{"username":"JaneDoe",
"email":"[email protected]",
"course_id":"course-v1:MOOCit-demo-2",
"display_name": "MOOCit demonstration Course #1",
"percent_grade":"0.20",
"letter_grade":"",
"passed_timestamp":null
"last_date":"2020-11-26"
}
...

Get grades by username

List grades by username

GET https://your-platform-url.com/api/so2/v1/grades?username={username}

Get course grades for a given username

Query Parameters

Name	Type	Description
username	string

Headers

Name	Type	Description
Access-Control-Request-Headers*	string	authorization
Authorization*	string	Bearer <auth_token>
Content-Type*	string	application/json

200

{"username":"johndoe",
"email":"[email protected]",
"course_id":"course-v1:MOOCit-demo-1",
"display_name": "MOOCit demonstration Course #1",
"percent_grade":"0.80",
"letter_grade":"Pass",
"passed_timestamp":"2020-03-28 23:21:24.354019"
"last_date":"2020-11-26"
}, 
{"username":"johndoe",
"email":"[email protected]",
"course_id":"course-v1:MOOCit-demo-1",
"display_name": "MOOCit demonstration Course #1",
"percent_grade":"0.20",
"letter_grade":"",
"passed_timestamp":null
"last_date":"2020-11-26"
}
...