List Subscriber Assignment Submissions
Returns one subscriber's assignment scores and reviewer feedback across your courses. Use it to synchronize grading without requesting each course or assignment separately. List Subscribers supplies the subscriber identifier.
Submission selection
- Each current assignment appears at most once, using its latest submitted attempt; an unfinished newer retake does not replace the previous submitted attempt.
- Published and unpublished courses and assignments are eligible, but deleted courses and assignments are absent.
- Revoking the subscriber's course access does not remove their historical submissions.
Scores and feedback
- Pending reviews remain visible with any marks awarded so far; ungraded questions use
awardedMarks: null, andpassedremainsnulluntil review is complete. - Course and assignment titles are current, while marks, passing percentage, questions, and feedback reflect the selected attempt; later assignment edits do not rewrite historical grading.
- Learner answers, correct options, attachments, and storage metadata are never returned.
Pagination
Results are ordered by submittedAt descending, then submissionId descending. Pagination is offset-based, so a submission arriving during a multi-page read can shift later pages; de-duplicate by assignmentId or restart the read when consistency matters. The operation is read-only and safe to retry.
External access policy
An API key and an authorized white-label host are required. Both tier and plan requirements are enforced.
These requirements apply to the white-label creator for backend-to-backend access. TagMango platform access is not supported.
-
Plans: Unrestricted.
-
Tiers: Unrestricted.
Authorization
bearer In: header
Path Parameters
The subscriber whose assignment submissions are returned, as a 24-character hexadecimal ObjectId. Use data[].customer._id from List Subscribers; the subscriber must belong to the authenticated host, and an identifier from another host is reported as not found.
Query Parameters
Comma-separated list of one to 50 24-character hexadecimal Course ObjectIds from List Courses by Creator. A submission matches when its course is any listed course. Omit to include every current course you own; unknown and other-creators' identifiers contribute no matches while valid identifiers still apply.
One-based page number over the latest submitted attempt for each assignment. A page past the end returns an empty data array while total remains unchanged. Omit for page 1.
11 <= valueMaximum submissions returned on this page. Omit to return 25.
251 <= value <= 50Header Parameters
Host name of the dashboard, ex: mydomain.tagmango.com
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api-prod-new.tagmango.com/api/v1/external/courses/assignments/submissions/66c4964c11e7fef26751f3a7" \ -H "x-whitelabel-host: string"{
"data": [
{
"submissionId": "66d111111111111111111111",
"courseId": "64a7b8c9d1e2f3a4b5c6d7e8",
"courseTitle": "Mastering TypeScript",
"assignmentId": "66a222222222222222222222",
"assignmentTitle": "Generics Review",
"reviewStatus": "reviewed",
"marksObtained": 8,
"totalMarks": 10,
"scorePercent": 80,
"passingPercent": 60,
"passed": true,
"submittedAt": "2026-09-10T08:00:00.000Z",
"reviewedAt": "2026-09-10T09:00:00.000Z",
"reattemptCount": 1,
"questionFeedback": [
{
"questionId": "66a333333333333333333333",
"question": "Explain how a generic constraint narrows a type parameter.",
"type": "text",
"possibleMarks": 10,
"awardedMarks": 8,
"reviewerRemarks": [
"Good explanation; include a concrete example next time."
]
}
]
}
],
"total": 42,
"page": 1,
"limit": 25
}{
"code": 400,
"type": "Bad Request",
"statusMessage": "BAD_REQUEST",
"success": false,
"message": "Invalid request",
"result": "Invalid request"
}{
"code": 401,
"type": "Unauthorized",
"statusMessage": "UNAUTHORIZED",
"message": "Invalid token",
"result": "Invalid token",
"success": false
}{
"code": 403,
"type": "Forbidden",
"statusMessage": "FORBIDDEN",
"errorCode": "WORKSHOP_MANGO_FORBIDDEN",
"message": "You can not access this api with a TagMango account, only available for whitelabel hosts",
"result": "You can not access this api with a TagMango account, only available for whitelabel hosts",
"success": false
}{
"code": 404,
"type": "Not Found",
"statusMessage": "NOT_FOUND",
"errorCode": "COURSE_LEARNER_NOT_FOUND",
"message": "No subscriber with this ID exists on the authenticated host. A subscriber belonging to another host is answered identically. Choose `data[].customer._id` from [List Subscribers](https://docs.tagmango.com/docs/api-reference/subscribers/listSubscribers) and retry.",
"result": "No subscriber with this ID exists on the authenticated host. A subscriber belonging to another host is answered identically. Choose `data[].customer._id` from [List Subscribers](https://docs.tagmango.com/docs/api-reference/subscribers/listSubscribers) and retry.",
"success": false
}{
"code": 429,
"type": "Too Many Requests",
"statusMessage": "TOO_MANY_REQUESTS",
"message": "Request limit exceeded. try after 10 seconds",
"result": "Request limit exceeded. try after 10 seconds",
"success": false
}