class progress

Erik.E.3593
Erik.E.3593 Posts: 2 🔍

Hello everyone,

I'm currently working on integrating with the D2L Brightspace API and I'm trying to identify endpoints that provide comprehensive class progress information. Specifically, I'm looking for endpoints that can show:

  1. Overall class progress metrics
  2. Student grades across all assessment types
  3. Quiz completion and performance data
  4. Course access and engagement statistics
  5. Activity completion tracking

I've reviewed the documentation for grades, quizzes, and updates endpoints, but I'm wondering if there's a more consolidated way to retrieve this information rather than making multiple calls to different endpoints.

Is there a specific endpoint or combination of endpoints that would be most efficient for building a comprehensive class progress dashboard? Any guidance on best practices for retrieving and combining this data would be greatly appreciated.

Thank you in advance for your assistance!

Comments

  • Justin.B.253
    Justin.B.253 Posts: 55 🧭

    @Erik.E.3593 I've been working on multiple dashboards this year, student, instructor and an Admin Dashboard that is nearly complete. I have not found one API call or Data Hub file that will do it all. In nearly every report or process I have built, it has required more than one API call to get all the data I need and process it within D2L using JavaScript or Python on the desktop. You can get close using the Learner Usage Report from Data Hub with completion tracking and dates and how many activities or content have been competed in a course. But then you will need a different API call for running grades and depending on how deep you want to go with course access, you will need to run a different report for that as the Learner usage report will only have last access. If you have access to the Report Builder software, you could do all this in one file. Our college does, but I can already see that would be very difficult to build out, but it would be possible.

  • Justin.B.253
    Justin.B.253 Posts: 55 🧭

    @Erik.E.3593 This might help you.

    D2L Brightspace API Endpoints for Class Progress Dashboard

    🧑‍🎓 Student Info

    GET /d2l/api/lp/{version}/users/whoami

    Returns the current user’s ID, role, and basic profile info.

    GET /d2l/api/lp/{version}/users/{userId}

    Returns full user profile: name, email, org ID, username, etc.

    🏫 Classlist & Course Access

    GET /d2l/api/le/{version}/{orgUnitId}/classlist/

    Returns enrolled users in the course with LastAccessedDate.

    📝 Grades

    GET /d2l/api/le/{version}/{orgUnitId}/grades/

    Lists all grade items in the course.

    GET /d2l/api/le/{version}/{orgUnitId}/grades/values/{userId}

    Returns scores for each grade item for a user.

    GET /d2l/api/le/{version}/{orgUnitId}/grades/final/values/{userId}

    Returns the user’s final course grade.

    ❓ Quizzes

    GET /d2l/api/le/{version}/{orgUnitId}/quizzes/

    Lists all quizzes in a course.

    GET /d2l/api/le/{version}/{orgUnitId}/quizzes/{quizId}/attempts/

    Lists all attempts for a quiz (admin access).

    GET /d2l/api/le/{version}/{orgUnitId}/quizzes/{quizId}/users/{userId}/attempts/

    Returns a user’s quiz attempts with score and status.

    📚 Content Progress

    GET /d2l/api/le/{version}/{orgUnitId}/content/root/

    Returns course content structure (modules/topics).

    GET /d2l/api/le/{version}/{orgUnitId}/content/userprogress/{userId}/

    Shows which modules/topics a student has viewed/completed.

    📂 Assignments (Dropbox)

    GET /d2l/api/le/{version}/{orgUnitId}/dropbox/folders/

    Lists all assignment dropboxes in the course.

    GET /d2l/api/le/{version}/{orgUnitId}/dropbox/folders/{folderId}/submissions/{userId}

    Returns a student’s submission data for a folder.

    🚫 Not Publicly Available (UI-only or via Data Hub)

    Checklist completion

    Not available via REST API.

    Discussion participation metrics

    Not available via REST API.

    Login history across courses

    Use Data Hub or EventLog service.