Learning Plan Progress API — Queries

Retrieve per-user learning plan progress records for the authenticated company.

Endpoint
POSThttps://api.udacity.com/api/public/api/v1/learning-plan-progress/graphql

learningPlanProgress

Required scope: COMPANY:<companyId>

Input fields

planIdID!Required

The learning plan ID to retrieve progress for.

filterLearningPlanProgressFilter

Filter criteria.

orderByLearningPlanProgressOrderBy

Field to sort results by.

orderSortOrder

Sort direction (ASC or DESC).

firstInt

Maximum results to return (default 50).

afterString

Cursor for forward pagination.

Filter fields

userIds[ID!]

Filter by specific user IDs.

subscriptionStatus[SubscriptionStatus!]

Filter by subscription status.

Returns: LearningPlanProgressConnection!

Signature
type Query {
  learningPlanProgress(input: LearningPlanProgressInput!): LearningPlanProgressConnection!
}
Query
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
        planId
        subscriptionStatus
        requiredStepsTotal
        requiredStepsCompleted
        assessmentsComplete
        startedAt
        lastActiveAt
        completedAt
        createdAt
        updatedAt
      }
    }
  }
}
Variables
{
  "planId": "YOUR_PLAN_ID"
}
Response
{
  "data": {
    "learningPlanProgress": {
      "totalCount": 48,
      "pageInfo": {
        "hasNextPage": true,
        "endCursor": "eyJpZCI6IjEwIn0="
      },
      "edges": [
        {
          "node": {
            "userId": "8a386eac-5a18-4229-88a4-add7f1ee600f",
            "planId": "fd6f0490-2072-43b0-b1d0-7ee82fe96df2",
            "subscriptionStatus": "ACTIVE",
            "requiredStepsTotal": 5,
            "requiredStepsCompleted": 3,
            "assessmentsComplete": 2,
            "startedAt": "2026-01-15T10:00:00Z",
            "lastActiveAt": "2026-03-10T14:30:00Z",
            "completedAt": null,
            "createdAt": "2026-01-15T10:00:00Z",
            "updatedAt": "2026-03-10T14:30:00Z"
          }
        }
      ]
    }
  }
}

learningPlanStepProgress

Required scope: COMPANY:<companyId>

Returns per-user, per-step progress for a learning plan. Each record describes one user’s progress on one step.

Input fields

planIdID!Required

The learning plan ID to retrieve step progress for.

filterLearningPlanStepProgressFilter

Filter criteria.

orderByLearningPlanStepProgressOrderBy

Field to sort results by.

orderSortOrder

Sort direction (ASC or DESC).

firstInt

Maximum results to return (default 50).

afterString

Cursor for forward pagination.

Filter fields

userIds[ID!]

Filter by specific user IDs.

stepIds[ID!]

Filter by specific step IDs.

status[StepStatus!]

Filter by step status.

requiredBoolean

Filter to only required or only optional steps.

stepTypes[LearningPlanStepType!]

Filter to steps of the given types (e.g. ASSESSMENT, PROGRAM). Intersects with stepIds when both are set.

startedAt[DateRangeInput!]

Filter by when the step was started. Multiple ranges are OR-ed.

completedAt[DateRangeInput!]

Filter by when the step was completed. Multiple ranges are OR-ed.

updatedAt[DateRangeInput!]

Filter by when the step progress was last updated. Multiple ranges are OR-ed.

subscriptionStatus[SubscriptionStatus!]

Filter by subscription status.

Assessment steps: requirements, satisfied, satisfiedAt, and progress are aligned positionally — index i of each list describes the same requirement. For an assessment step, satisfied[i] is the per-requirement pass/fail and progress[i] is the achieved score.

Returns: LearningPlanStepProgressConnection!

Signature
type Query {
  learningPlanStepProgress(input: LearningPlanStepProgressInput!): LearningPlanStepProgressConnection!
}
Query
query GetLearningPlanStepProgress($planId: ID!) {
  learningPlanStepProgress(input: {
    planId: $planId
    filter: { status: [STARTED, COMPLETED] }
    orderBy: UPDATED_AT
    order: DESC
    first: 10
  }) {
    totalCount
    pageInfo { hasNextPage endCursor }
    edges {
      node {
        userId
        planId
        stepId
        subscriptionStatus
        status
        required
        requirements
        satisfied
        satisfiedAt
        progress
        startedAt
        completedAt
        lastActiveAt
        createdAt
        updatedAt
      }
    }
  }
}
Variables
{
  "planId": "YOUR_PLAN_ID"
}
Response
{
  "data": {
    "learningPlanStepProgress": {
      "totalCount": 240,
      "pageInfo": {
        "hasNextPage": true,
        "endCursor": "eyJpZCI6IjEwIn0="
      },
      "edges": [
        {
          "node": {
            "userId": "3f9a1b2c-7d4e-4a5b-8c6d-1e2f3a4b5c6d",
            "planId": "fd6f0490-2072-43b0-b1d0-7ee82fe96df2",
            "stepId": "2c0a4fe4-7687-43f9-b749-891e5c636a65",
            "subscriptionStatus": "ACTIVE",
            "status": "COMPLETED",
            "required": true,
            "requirements": ["a1b2c3d4-0000-0000-0000-000000000001"],
            "satisfied": [true],
            "satisfiedAt": ["2026-03-10T14:30:00Z"],
            "progress": [92.0],
            "startedAt": "2026-02-01T09:00:00Z",
            "completedAt": "2026-03-10T14:30:00Z",
            "lastActiveAt": "2026-03-10T14:30:00Z",
            "createdAt": "2026-02-01T09:00:00Z",
            "updatedAt": "2026-03-10T14:30:00Z"
          }
        }
      ]
    }
  }
}