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

NameTypeDescription

Access-Control-Request-Headers*

string

authorization

Authorization*

string

Bearer <auth_token>

Content-Type*

string

application/json

{"username":"johndoe",
"email":"john@example.com",
"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":"jane@example.com",
"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

NameTypeDescription

course_id

string

the course_id course-v1:org+num+session

Headers

NameTypeDescription

Access-Control-Request-Headers*

string

authorization

Authorization*

string

Bearer <auth_token>

Content-Type*

string

application/json

{"username":"johndoe",
"email":"john@example.com",
"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":"jane@example.com",
"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

NameTypeDescription

username

string

Headers

NameTypeDescription

Access-Control-Request-Headers*

string

authorization

Authorization*

string

Bearer <auth_token>

Content-Type*

string

application/json

{"username":"johndoe",
"email":"john@example.com",
"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":"john@example.com",
"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"
}
...

Last updated