Submission Report
Returns submissions (tests, exercises, assignments and assessments) made by learners in your organization, newest first, with marks and evaluation status. Use it to pull results into your own reporting or to find submissions waiting to be evaluated.
GET
/submissionsSubmission Report
curl --request GET \
--url 'https://<your-api-host>/nuSource/api/v1/submissions?page=1&per_page=10&sort_order=D&sort_by=submission_time&start_date=1732838400&end_date=1732924800&evaluated=-1' \
--header 'APIKEY: <your-api-key>' \
--header 'ORGID: <your-org-id>'{
"code": 200,
"message": "Success",
"submission": [
{
"name": "Manju",
"contact_number": "9110874908",
"id": 10724,
"username": "gggg2",
"email": "manju@gmail.com",
"institution_id": 1,
"assessment_type": 7,
"assessment_id": 588,
"assessment_name": "Homework Assignment 1",
"session_name": null,
"marks_obtained": 0,
"total_marks": 25,
"grade": null,
"passed": 0,
"attempt_id": 5067,
"is_evaluated": 0,
"assessment_session_id": null,
"submission_time": "1732794016",
"percentage": "0.00",
"organization_id": "2",
"master_batch_id": "580",
"master_batch_name": "Master Hdhdh",
"class_id": "704",
"course_id": 25,
"course_name": "IBPS Clerk Mains Test Series"
},
{
"name": "Manju",
"contact_number": "9110874908",
"id": 10724,
"username": "gggg2",
"email": "manju@gmail.com",
"institution_id": 1,
"assessment_type": 6,
"assessment_id": 489,
"assessment_name": "Free Preview",
"session_name": null,
"marks_obtained": -1,
"total_marks": 21,
"grade": null,
"passed": 0,
"attempt_id": 5065,
"is_evaluated": 1,
"assessment_session_id": null,
"submission_time": "1732544172",
"percentage": "-4.76",
"organization_id": "2",
"master_batch_id": "722",
"master_batch_name": "Test Total Classes",
"class_id": "901",
"course_id": 25,
"course_name": "IBPS Clerk Mains Test Series"
},
{
"name": "Manju",
"contact_number": "9110874908",
"id": 10724,
"username": "gggg2",
"email": "manju@gmail.com",
"institution_id": 1,
"assessment_type": 6,
"assessment_id": 489,
"assessment_name": "Free Preview",
"session_name": null,
"marks_obtained": 1,
"total_marks": 23,
"grade": "D",
"passed": 0,
"attempt_id": 5064,
"is_evaluated": 0,
"assessment_session_id": null,
"submission_time": "1732539459",
"percentage": "4.35",
"organization_id": "2",
"master_batch_id": "722",
"master_batch_name": "Test Total Classes",
"class_id": "901",
"course_id": 25,
"course_name": "IBPS Clerk Mains Test Series"
},
{
"name": "Manju",
"contact_number": "9110874908",
"id": 10724,
"username": "gggg2",
"email": "manju@gmail.com",
"institution_id": 1,
"assessment_type": 6,
"assessment_id": 489,
"assessment_name": "Free Preview",
"session_name": null,
"marks_obtained": 0,
"total_marks": 23,
"grade": "D",
"passed": 0,
"attempt_id": 5059,
"is_evaluated": 0,
"assessment_session_id": null,
"submission_time": "1732536969",
"percentage": "0.00",
"organization_id": "2",
"master_batch_id": "722",
"master_batch_name": "Test Total Classes",
"class_id": "901",
"course_id": 25,
"course_name": "IBPS Clerk Mains Test Series"
},
{
"name": "Manju",
"contact_number": "9110874908",
"id": 10724,
"username": "gggg2",
"email": "manju@gmail.com",
"institution_id": 1,
"assessment_type": 6,
"assessment_id": 489,
"assessment_name": "Free Preview",
"session_name": null,
"marks_obtained": 0,
"total_marks": 23,
"grade": "D",
"passed": 0,
"attempt_id": 5058,
"is_evaluated": 0,
"assessment_session_id": null,
"submission_time": "1732536503",
"percentage": "0.00",
"organization_id": "2",
"master_batch_id": "722",
"master_batch_name": "Test Total Classes",
"class_id": "901",
"course_id": 25,
"course_name": "IBPS Clerk Mains Test Series"
},
{
"name": "Manju",
"contact_number": "9110874908",
"id": 10724,
"username": "gggg2",
"email": "manju@gmail.com",
"institution_id": 1,
"assessment_type": 6,
"assessment_id": 489,
"assessment_name": "Free Preview",
"session_name": null,
"marks_obtained": 0,
"total_marks": 23,
"grade": "D",
"passed": 0,
"attempt_id": 5051,
"is_evaluated": 0,
"assessment_session_id": null,
"submission_time": "1732530236",
"percentage": "0.00",
"organization_id": "2",
"master_batch_id": "722",
"master_batch_name": "Test Total Classes",
"class_id": "901",
"course_id": 25,
"course_name": "IBPS Clerk Mains Test Series"
},
{
"name": "Manju",
"contact_number": "9110874908",
"id": 10724,
"username": "gggg2",
"email": "manju@gmail.com",
"institution_id": 1,
"assessment_type": 6,
"assessment_id": 1100,
"assessment_name": "Online 1",
"session_name": null,
"marks_obtained": -11,
"total_marks": 8,
"grade": null,
"passed": 0,
"attempt_id": 5049,
"is_evaluated": 0,
"assessment_session_id": null,
"submission_time": "1732525989",
"percentage": "-137.",
"organization_id": "2",
"master_batch_id": "3075",
"master_batch_name": "Course A - Batch A",
"class_id": "6263",
"course_id": 1539,
"course_name": "Course A"
},
{
"name": "Manju",
"contact_number": "9110874908",
"id": 10724,
"username": "gggg2",
"email": "manju@gmail.com",
"institution_id": 1,
"assessment_type": 6,
"assessment_id": 489,
"assessment_name": "Free Preview",
"session_name": null,
"marks_obtained": -1,
"total_marks": 23,
"grade": null,
"passed": 0,
"attempt_id": 5046,
"is_evaluated": 0,
"assessment_session_id": null,
"submission_time": "1732520032",
"percentage": "-4.35",
"organization_id": "2",
"master_batch_id": "722",
"master_batch_name": "Test Total Classes",
"class_id": "901",
"course_id": 25,
"course_name": "IBPS Clerk Mains Test Series"
},
{
"name": "Manju",
"contact_number": "9110874908",
"id": 10724,
"username": "gggg2",
"email": "manju@gmail.com",
"institution_id": 1,
"assessment_type": 6,
"assessment_id": 489,
"assessment_name": "Free Preview",
"session_name": null,
"marks_obtained": 0,
"total_marks": 23,
"grade": "D",
"passed": 0,
"attempt_id": 5044,
"is_evaluated": 0,
"assessment_session_id": null,
"submission_time": "1732516750",
"percentage": "0.00",
"organization_id": "2",
"master_batch_id": "722",
"master_batch_name": "Test Total Classes",
"class_id": "901",
"course_id": 25,
"course_name": "IBPS Clerk Mains Test Series"
},
{
"name": "Manju",
"contact_number": "9110874908",
"id": 10724,
"username": "gggg2",
"email": "manju@gmail.com",
"institution_id": 1,
"assessment_type": 7,
"assessment_id": 990,
"assessment_name": "Offline stuff",
"session_name": null,
"marks_obtained": 0,
"total_marks": 10,
"grade": null,
"passed": 1,
"attempt_id": 5021,
"is_evaluated": 0,
"assessment_session_id": null,
"submission_time": "1732181691",
"percentage": "0.00",
"organization_id": "2",
"master_batch_id": "722",
"master_batch_name": "Test Total Classes",
"class_id": "901",
"course_id": 25,
"course_name": "IBPS Clerk Mains Test Series"
}
],
"page_context": {
"page": 1,
"per_page": 10,
"has_more_page": true,
"total_rows": 56,
"sort_by": "submission_time",
"sort_order": "D"
}
}Access: Institute admins, admins and tutors, plus custom roles that can view submissions. Tutors and custom roles without access to all batches see only submissions from batches they teach.
Query parameters
Only submissions on or after this time. Applied only together with
end_date. Keep the range short (one day is recommended), as wide ranges are slow.Only submissions on or before this time.
evaluatedinteger
1 evaluated only, 0 not yet evaluated only, -1 all (default).searchstring
Matches part of the learner's name, phone number, email or registration number. Up to 100 characters.
filtersJSON string
Extra filters (keys below).
per_pageinteger
Results per page. Default 50.
cursorinteger
For the next page, send
page_context.cursor from the previous response.include_total_recordsinteger
1 returns only page_context.total_records (the total count) and no list.sort_orderstring
D newest first (default) or A oldest first.Keys in filters:
| Name | Required | Type | Description |
|---|---|---|---|
| course_id | No | array of integers | Course IDs. |
| batch_id | No | array of integers | Batch IDs. |
| assessment_type | No | array of integers | Types to include (see below). |
| tutor_id | No | array of integers | Only batches taught by these tutors. Ignored when a tutor calls. |
| assessment_name | No | array | Specific assessments: objects with assessment_id and assessment_type. |
| result_declaration | No | string | declared or not_declared (tests and exercises only). |
| product_type | No | array of integers | Product types of the course (1 course, 5 ebook, 6 test series, 7 playlist). |
Response
codeinteger
Example:
200messagestring
Example:
Successsubmissionobject[]
Show child attributesHide child attributes
submission.namestring
Example:
ManjuExample:
9110874908submission.idinteger
Example:
10724submission.usernamestring
Example:
gggg2submission.emailstring
Example:
manju@gmail.comsubmission.institution_idinteger
Example:
1submission.assessment_typeinteger
Example:
7submission.assessment_idinteger
Example:
588Example:
Homework Assignment 1submission.marks_obtainedinteger
Example:
0submission.total_marksinteger
Example:
25submission.gradenull
submission.passedinteger
Example:
0submission.attempt_idinteger
Example:
5067submission.is_evaluatedinteger
Example:
0submission.percentagestring
Example:
0.00Example:
2Example:
580Example:
Master Hdhdhsubmission.class_idstring
Example:
704submission.course_idinteger
Example:
25submission.course_namestring
Example:
IBPS Clerk Mains Test Seriespage_contextobject
Show child attributesHide child attributes
page_context.pageinteger
Example:
1page_context.per_pageinteger
Example:
10page_context.has_more_pageboolean
Example:
truepage_context.total_rowsinteger
Example:
56page_context.sort_bystring
Example:
submission_timepage_context.sort_orderstring
Example:
DNotes: Only your ORGID organization is covered. Email and phone come back empty if your institute restricts confidential fields for your role. Rate limit: 30 requests per minute; going over locks you out for 30 minutes.