TagMangoTagMango Docs
Course

List Subscriber Assignment Submissions

GET
/api/v1/external/courses/assignments/submissions/{userId}

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, and passed remains null until 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.

AuthorizationBearer <token>

In: header

Path Parameters

userId*string

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

courseIds?string

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.

page?integer

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.

Default1
Range1 <= value
limit?integer

Maximum submissions returned on this page. Omit to return 25.

Default25
Range1 <= value <= 50

Header Parameters

x-whitelabel-host*string

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
}