Skip to main content
GET
/
api
/
public
/
courses
/
v2
/
{courseId}
/
lessons

List Course Lessons

Returns the ordered list of lessons for a specific course. Used to render the course syllabus and track which lessons the customer has completed.

Authentication

Requires a valid customer bearer token to include completion status.

Path Parameters

courseId
number
required
Numeric identifier of the course. Returned as Id from GET /api/public/courses/v2.

Query Parameters

_shape
string
Comma-separated list of field paths to include in the response. When provided, only the specified fields are returned — useful for reducing payload size. Supports nested paths using dot notation.

Response

Returns a CourseSummary object containing the lessons array and course-level metadata.

Top-Level Fields

FieldTypeDescription
EnrolledbooleanWhether the customer is enrolled in the course
CompletedbooleanWhether the customer has completed the course
CompletenessnumberCompletion percentage (0–1)
CanAccessCoursebooleanWhether the customer can access course content
AttendeeCountnumberNumber of enrolled attendees
LessonsCountnumberTotal number of lessons
CreatedOnUtcstringCourse creation date (UTC)

Attendee (current customer)

FieldTypeDescription
IdnumberAttendee record identifier
FullNamestringAttendee full name
EmailstringAttendee email
CreatedOnstringEnrollment date (business-local)
CreatedOnUtcstringEnrollment date (UTC)

Course

FieldTypeDescription
IdnumberCourse identifier
TitlestringCourse title
SummaryTextstringShort course summary
FullDescriptionstringFull course description (HTML)
OverviewTextstringCourse overview text
GroupNamestringCourse group / category name
VisibilitystringVisibility setting
ActivebooleanWhether the course is active
ShowInHomePagebooleanWhether shown on the home page
ShowOverviewbooleanWhether the overview tab is visible
HasCommunityGroupbooleanWhether the course has a discussion group
CreatedOnstringDate created (business-local time)
CreatedOnUtcstringDate created (UTC)
UpdatedOnstring | nullDate last updated (business-local time)
UpdatedOnUtcstring | nullDate last updated (UTC)

Lessons Array

FieldTypeDescription
IdnumberLesson identifier
TitlestringLesson title
SummaryTextstringLesson summary text
DisplayOrdernumberSort order within the course
IsOpenbooleanWhether the lesson is available
IsCompletebooleanWhether the customer has completed it

Lessons Section (nested)

FieldTypeDescription
Section.IdnumberSection identifier
Section.TitlestringSection title
Section.DisplayOrdernumberSection sort order

Other

FieldTypeDescription
Tariffobject | nullAssociated plan/tariff (if any)
Hostobject | nullCourse host profile
CommunityGroupobject | nullLinked discussion group (Id, Name)
CurrentLessonobject | nullThe first open, incomplete lesson

Examples

Fetch lessons for a course

GET /api/public/courses/v2/42/lessons
Authorization: Bearer {token}

TypeScript Integration

import endpoints from '@/api/endpoints'

const { resource: lessons } = useTypedData(httpClient, endpoints.courses.lessons(42))