API endpoint to get a user's assignment score/grade

Question

Hello,

New to Canvas here and am trying to convert some old LMS processes to the Canvas API. I'm able to use the API to get a course section, the sections students, and the assignments for a section. I've searched and searched but I am unable to find an endpoint that will return a student's score for an assignment, or a bulk list of assignment submissions. Is there an API endpoint to accomplish this?

Thanks,

Bobby

Chris · Accepted Answer

Hi @BobRoss,

You'd want to use one of the submissions APIs for this.  A submission object will have a "score" element, which is the number of points the submission earned.

-Chris

melodyc_lam · Accepted Answer

@BobRoss Welcome!

You're looking for the List Assignment Submissions endpoint which can pull all the assignment submissions (paginated) or for a single student, Get A Single Submission.

Just as a pro tip, if your students have SIS IDs, use the SIS IDs "substitution"  to save yourself a call to retrieve the student's Canvas user IDs. So for example, a call could look like "https://[institution].instructure.com/api/v1/courses/[course id]/assignments/[assignment id]/submissions/sis_user_id:[the sis ID]"

Hope this helps!