Docs home

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/submissions
Submission 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
start_dateUnix timestampRecommended
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.
end_dateUnix timestampRecommended
Only submissions on or before this time.
evaluatedinteger
1 evaluated only, 0 not yet evaluated only, -1 all (default).
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.
1 returns only page_context.total_records (the total count) and no list.
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).
Response200application/json
codeinteger
Example: 200
messagestring
Example: Success
submissionobject[]
Show child attributesHide child attributes
Example: Manju
Example: 9110874908
Example: 10724
Example: gggg2
Example: manju@gmail.com
Example: 1
Example: 588
Example: Homework Assignment 1
Example: 0
Example: 25
Example: 0
Example: 5067
Example: 0
Unix timestamp
Example: 1732794016
Example: 0.00
Example: 580
Example: Master Hdhdh
Example: 704
Example: 25
Example: IBPS Clerk Mains Test Series
Show child attributesHide child attributes
Example: 1
Example: 10
Example: true
Example: 56
Example: submission_time
Example: D

Notes: 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.

Updated yesterday

Ask AI