In short
With the progress:read scope, read one learner's progress on one course, all their courses, or everyone on a course. Each row has status, percentage, dates, quiz results, attendance, sign-off and certificate. Everything comes from stored data; nothing is recalculated when you read it.
All progress endpoints need progress:read.
| Method | Path | What it does |
|---|---|---|
| GET | /users/{user}/progress/{course} |
One user on one course |
| GET | /users/{user}/progress |
One user across their courses |
| GET | /courses/{course}/progress |
Everyone enrolled on a course |
The lists are cursor-paginated (see Pagination) and default to 50 rows a page, up to 100.
The progress object
{
"user_id": 2,
"course_id": 412,
"enrolment_status": "enrolled",
"status": "completed",
"percentage": 100,
"percentage_updated_at": "2026-11-08T16:40:12+00:00",
"started_at": "2026-11-01T09:12:44+00:00",
"last_activity_at": "2026-11-08T16:40:12+00:00",
"completed_at": "2026-11-08T16:40:12+00:00",
"quizzes": [
{
"column_id": "c-8f2a",
"title": "End of course quiz",
"attempts": 2,
"best_score": 90,
"last_score": 90,
"pass_score": 80,
"passed": true,
"last_submitted_at": "2026-11-08T16:38:55+00:00"
}
],
"attendance": { "applicable": false, "attended": false, "attended_at": null, "live_minutes": null },
"signoff": null,
"certificate": {
"number": "CL-58-01JC2Y8QW7S0R4M9K3T6V2X1BN",
"state": "valid",
"awarded_at": "2026-11-08T16:40:12+00:00",
"expires_at": "2029-11-08T16:40:12+00:00",
"verify_url": "https://acme.continuumlearn.com/verify/..."
}
}
| Field | Description |
|---|---|
enrolment_status |
The same values as an enrolment's status. |
status |
not_started, in_progress or completed. A course is completed when its stored percentage is 100 or more, or a completion has been recorded. |
percentage |
The stored percentage, 0 to 100. |
started_at, last_activity_at |
First and latest recorded activity on the course. |
completed_at |
When the completion was recorded. For older completions with no record, the time the percentage last changed, which is approximate. |
quizzes |
One entry per quiz in the course the learner has submitted: attempts, best and last score, the pass mark, whether any attempt passed, and the last submission. Attempt history is kept from July 2026, so earlier attempts don't appear. |
attendance |
For in-person courses and courses with Zoom sessions (applicable: true): whether and when attendance was marked, and total live minutes from Zoom. |
signoff |
null when the course needs no sign-off; otherwise {required: true, signed_at}. |
certificate |
null until a certificate is issued. state is valid, expired, revoked or unsigned. verify_url is the public verification page, or null when verification is turned off in the certificate template. |
Examples
# One learner on one course
curl https://your-team.continuumlearn.com/api/v2/users/2/progress/412 \
-H "Authorization: Bearer $CONTINUUM_API_KEY"
# Everyone who completed a course since 1 November
curl "https://your-team.continuumlearn.com/api/v2/courses/412/progress?status=completed&completed_since=2026-11-01T00:00:00Z&limit=100" \
-H "Authorization: Bearer $CONTINUUM_API_KEY"
GET /users/{user}/progress/{course} returns 200 even when the user isn't enrolled, with enrolment_status: not_enrolled and status: not_started.
| Query parameter | Endpoint | Description |
|---|---|---|
status |
Course list | not_started, in_progress or completed. |
completed_since |
Course list | ISO 8601: learners who completed since then. |
include_unenrolled |
Both lists | true to include people who were enrolled and then removed. |
The course list covers the same people as the course's enrolments: direct enrolments and members of auto groups. Each row includes the same compact user as the enrolment lists.
Things to know
- Progress is per cycle. On a course with a recurring training requirement, a learner who renews is reset: the earlier cycle's progress, quiz attempts and sign-off are archived, so the API shows the current cycle and a renewed learner drops back to
not_started(percentage0, nocompleted_at, quizattemptsback to0, and the sign-off'ssigned_atback tonull). Thecertificateis the one linked to the learner's current or most recently completed cycle. Earlier cycles aren't returned by this endpoint, but each one fired its owncourse.completedandcertificate.issuedwebhook when it finished. - Nothing is recalculated. The API reads what is stored, so reading progress never changes it and is cheap to call.
- Staff previews don't count. Administrators, authors and linked presenters who aren't enrolled are in observer mode: their activity isn't recorded as completions, so they show as not started.
- For changes as they happen, subscribe to the
course.completedandcertificate.issuedwebhooks instead of polling.
Frequently asked questions
Why is completed_at earlier than percentage_updated_at?
completed_at is the first recorded completion. The stored percentage can be written again after that, which moves percentage_updated_at but not completed_at.
Can I read CPD hours?
The course's CPD hours are on the course (cpd_hours in Catalogue). Pair them with completed_at to total a learner's CPD.