Learning Plan Progress API — Queries
Retrieve per-user learning plan progress records for the authenticated company.
learningPlanProgress
Required scope: COMPANY:<companyId>
Input fields
The learning plan ID to retrieve progress for.
Filter criteria.
Field to sort results by.
Sort direction (ASC or DESC).
Maximum results to return (default 50).
Cursor for forward pagination.
Filter fields
Filter by specific user IDs.
Filter by subscription status.
Returns: LearningPlanProgressConnection!
type Query {
learningPlanProgress(input: LearningPlanProgressInput!): LearningPlanProgressConnection!
}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
}
}
}
}{
"planId": "YOUR_PLAN_ID"
}{
"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
The learning plan ID to retrieve step progress for.
Filter criteria.
Field to sort results by.
Sort direction (ASC or DESC).
Maximum results to return (default 50).
Cursor for forward pagination.
Filter fields
Filter by specific user IDs.
Filter by specific step IDs.
Filter by step status.
Filter to only required or only optional steps.
Filter to steps of the given types (e.g. ASSESSMENT, PROGRAM). Intersects with stepIds when both are set.
Filter by when the step was started. Multiple ranges are OR-ed.
Filter by when the step was completed. Multiple ranges are OR-ed.
Filter by when the step progress was last updated. Multiple ranges are OR-ed.
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!
type Query {
learningPlanStepProgress(input: LearningPlanStepProgressInput!): LearningPlanStepProgressConnection!
}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
}
}
}
}{
"planId": "YOUR_PLAN_ID"
}{
"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"
}
}
]
}
}
}