/grades

Description

Grades are created when users submit their assignments. The grade is calculated based on the user's scores on the graded tasks and quizzes in the assignment.

get
Retrieve Grades

https://api.next.tech/v1/grades
Request
Response
Request
Query Parameters
course_uid
optional
string
An array of course API keys formatted as a query string, e.g. course_uid[]=196e2e6a-ecd2-48c2-ae28-d6e76a7327a8&course_uid[]=6e17916f-8a3d-40d6-9a89-2cf6742379d3 Only grades for projects in one of the specified courses will be returned.
before
optional
string
Retrieve contents that were created before the specified date. The date format is ISO 8601. E.g., 2020-10-7T23:13:00.000Z
after
optional
string
Retrieve contents that were created after the specified date. The date format is ISO 8601. E.g., 2019-10-7T00:00:00.000Z
project_metadata
optional
array
An array of project metadata key and value pairs formatted as a query string, e.g. project_metadata[][key]=level&project_metadata[][value]=intermediate&project_metadata[][key]=language&project_metadata[][value]=python Only grades for projects with one or more matching metadata will be returned.
course_metadata
optional
array
An array of course metadata key and value pairs formatted as a query string, e.g. course_metadata[][key]=course&course_metadata[][value]=Python&course_metadata[][key]=id&course_metadata[][value]=1 Only grades for courses with one or more matching metadata will be returned.
Response
200: OK
[
{
"created_at": 1574448113,
"updated_at": 1574448113,
"id": 1,
"course_metadata": [],
"course_name": "Intro to Python",
"lesson_uid": "4b03d565-7302-4c0e-a051-5ae02761be11",
"project_created_at": 1574370869,
"project_metadata": [],
"project_name": "Using print statements in Python",
"project_option": "main.py",
"project_review_url": "https://next.tech/projects/8cfa959270ae/share?p=2jkf8e5a9295574ba&review=true",
"project_share_url": "https://next.tech/projects/8cfa959270ae/share",
"project_snapshot_created_at": 1574448114,
"project_snapshot_download_url": "https://storage.googleapis.com...",
"project_snapshot_updated_at": 1574448115,
"project_snapshot_uid": "d799af19-ec6d-4dcc-a697-61234f0a7d61",
"project_snapshots_count": 45,
"project_time_spent": 68,
"project_updated_at": 1603394884,
"project_uid": "e435779a-786e-4c9c-a640-5a58a5c619a2",
"user_created_at": 1537326315,
"user_email": "[email protected]",
"user_first_name": "Codey",
"user_id": 1,
"user_last_name": "Codester",
"user_updated_at": 1537326315,
"score": 1.0,
"task_results": [
{
"id": 1,
"created_at": "2019-11-21T21:14:30.150Z",
"p_created_at": "21:14:30",
"p_updated_at": "18:41:54",
"t_created_at": 1574370870.1502369,
"t_updated_at": 1574448114.4681979,
"key": 1,
"attempts": 2,
"checks": [
{
"id": 1,
"created_at": "2018-08-20T19:55:15.147Z",
"p_created_at": "19:55:15",
"p_updated_at": "19:55:15",
"t_created_at": 1534794915.1461032,
"t_updated_at": 1534794915.1461032,
"key": 1,
"grade": true,
"pretty_type": "Code Pattern",
"record_id": 1,
"test_description": "Check for print statement",
"test_type": "code_pattern",
"type": "CodePattern"
}
],
"checks_count": 1,
"contents": "Write print statement.",
"description": "Write print statement.",
"feedback": null,
"grade": true,
"progress": 1.0,
"task_created_at": 1534794916,
"score": 1.0,
"share_checks": true,
"uid": "0f0edd19-51f1-4586-99ad-2c7a065f6008",
"weight": 1.0,
"complete": true,
"project_task_uid": "0f0edd19-51f1-4586-99ad-2c7a065f6008"
}
],
"test_results": {
"code_pattern_results": [
{
"id": 1,
"created_at": "2019-11-22T18:41:54.461Z",
"p_created_at": "18:41:54",
"p_updated_at": "18:41:54",
"t_created_at": 1574448114.4618612,
"t_updated_at": 1574448114.4618612,
"key": 1,
"description": "Write print statement.",
"passed": true,
"project_snapshot_id": 1,
"project_snapshot_uid": "d799af19-ec6d-4dcc-a697-61234f0a7d61",
"project_task_result_id": 1,
"test_id": 1,
"test_type": "code_pattern",
"pattern": "print"
}
],
"command_test_results": [],
"custom_test_results": [],
"browser_simulation_results": [],
"html_parser_results": [],
"image_test_results": [],
"issue_test_results": [],
"full_gui_test_results": [],
"python_gui_test_results": [],
"sql_test_results": [],
"test_case_results": [],
"unit_test_results": [],
"webpage_test_results": []
}
}
]

If you have a large number of grades on your account, it is advisable to use pagination or provide at least one of the above filters to improve request performance.