# CourseEnrollments Object

> Source: https://truto.one/docs/api-reference/unified-lms-api/courseenrollments/

Schema for the `CourseEnrollments` resource in **Unified LMS API**.

## Properties

- **`id`** _(string, required)_
  The unique identifier for the course enrollment record
- **`user`** _(object)_
  The learner associated with this record
  - **`id`** _(string)_
    The unique identifier for a user
  - **`name`** _(string)_
    The name of the user
  - **`emails`** _(array<object>)_
    The emails of the user
    - **`email`** _(string)_
      The email address
    - **`type`** _(string)_
      The type of email address
    - **`is_primary`** _(boolean)_
      Whether the email address is primary
- **`course`** _(object)_
  The course associated with this record
  - **`id`** _(string)_
    The unique identifier for the course
  - **`title`** _(string)_
    The title of the course
- **`status`** _(string)_
  The lifecycle status for the user in this course
  Allowed: `assigned`, `enrolled`, `in_progress`, `completed`, `passed`, `failed`, `withdrawn`, `expired`, `overdue`, `unknown`
- **`assigned_at`** _(string)_
  The date and time the course was assigned to the user, when available
- **`due_at`** _(string)_
  The due date for course completion, when available
- **`enrolled_at`** _(string)_
  The date and time the user enrolled or registered, when available
- **`started_at`** _(string)_
  The date and time the user started the course, when available
- **`last_activity_at`** _(string)_
  The date and time of the last recorded activity for this enrollment, when available
- **`completed_at`** _(string)_
  The date and time the user completed the course, when available
- **`progress_percent`** _(number)_
  Progress percentage from 0 to 100, when available
- **`time_spent_seconds`** _(integer)_
  Total time spent in seconds, when available
- **`score`** _(number)_
  The latest or final score, when available
- **`is_mandatory`** _(boolean)_
  Whether this enrollment is part of a mandatory assignment, when available
- **`assigned_by`** _(object)_
  The assigner of this course to the user, when available
  - **`id`** _(string)_
    The unique identifier for a user
  - **`name`** _(string)_
    The name of the user
- **`attempt_number`** _(integer)_
  The latest attempt number, when the LMS supports retakes
- **`attempts_count`** _(integer)_
  Total attempts count, when available
- **`urls`** _(array<object>)_
  The URLs of the course-enrollments
  - **`url`** _(string)_
    The URL
  - **`type`** _(string)_
    The type of URL
- **`created_at`** _(string)_
  The date and time the enrollment record was created
- **`updated_at`** _(string)_
  The date and time the enrollment record was last updated
- **`custom_fields`** _(object)_
  Provider or customer specific fields mapped into a flexible key-value object
- **`remote_data`** _(object)_
  Raw data returned from the remote API call.

## Methods

- [GET /unified/lms/course-enrollments](/docs/api-reference/unified-lms-api/courseenrollments/list) — List Course enrollments