# Progress and results

> 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](https://continuumlearn.com/developers/pagination)) and default to **50** rows a page, up to 100.

## The progress object

```json
{
  "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](https://continuumlearn.com/developers/enrolments)'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

```bash
# 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](https://continuumlearn.com/developers/enrolments): direct enrolments and members of `auto` groups. Each row includes the same compact `user` as the [enrolment lists](https://continuumlearn.com/developers/enrolments#the-enrolment-object).

## Things to know

- **Progress is per cycle.** On a course with a [recurring training requirement](https://continuumlearn.com/help/recurring-training), 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](https://continuumlearn.com/developers/webhooks) 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](https://continuumlearn.com/developers/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](https://continuumlearn.com/developers/catalogue)). Pair them with `completed_at` to total a learner's CPD.
