Progress and results

View as Markdown

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 (percentage 0, no completed_at, quiz attempts back to 0, and the sign-off's signed_at back to null). The certificate is 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 own course.completed and certificate.issued webhook 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.completed and certificate.issued webhooks 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.

Building an integration?

Tell us what you are connecting and we will help you plan it, or book a demo to see the API working.