Learning Plan Progress API

The Learning Plan Progress API provides per-user progress data for a specific learning plan, including subscription status, steps completed, assessment completion, and activity timestamps.

Endpoint

POST https://api.udacity.com/api/public/api/v1/learning-plan-progress/graphql

Required scope

COMPANY:<companyId>

Your API token must have a COMPANY scope with your company ID as the scope key. The requested plan ID must belong to your company.

Overview

Given a learning plan ID, this API returns per-user progress records showing how each learner is progressing through the plan.

For step-by-step detail, the learningPlanStepProgress query returns per-user, per-step progress — including step status, completion timestamps, and per-requirement progress (for assessment steps, the per-requirement pass/fail and achieved score).

DataDescription
SubscriptionUser ID, plan ID, subscription status (active, hidden, inactive)
Step progressRequired steps total vs. completed, assessments completed
ActivityStarted, last active, and completed timestamps

Example

query GetLearningPlanProgress($planId: ID!) {
  learningPlanProgress(input: {
    planId: $planId
    filter: { subscriptionStatus: [ACTIVE] }
    orderBy: LAST_ACTIVE_AT
    order: DESC
    first: 10
  }) {
    totalCount
    pageInfo { hasNextPage endCursor }
    edges {
      node {
        userId
        subscriptionStatus
        requiredStepsTotal
        requiredStepsCompleted
        assessmentsComplete
        startedAt
        lastActiveAt
        completedAt
      }
    }
  }
}

Next

  • Queries — Full query reference with all filters and sorting options
  • Types — All types, inputs, and enums