Lesson API - EaseLMS

Get Lesson Details

Retrieves detailed information about a specific lesson including content, quizzes, and resources. Requires enrollment in the parent course.

Path Parameters

string

required

Lesson ID

Response

object

Detailed lesson object

Show Lesson Object

number

Unique lesson identifier

string

Lesson title

string

Lesson type: “video”, “text”, or “quiz”

string

Video URL for video lessons (stored in dedicated column)

string

HTML or text content for text lessons

number

Estimated duration in minutes

boolean

Whether this lesson is required for course completion

number

Position of the lesson in the course

number

Parent course ID

array

Array of downloadable resource objects

array

Array of quiz question objects from the quiz_questions table

object

Parent course basic information (id, title, settings)

Example Request

curl https://your-domain.com/api/lessons/42

Example Response

{
  "lesson": {
    "id": 42,
    "title": "Introduction to Variables",
    "type": "video",
    "video_url": "https://example.com/video.mp4",
    "text_content": null,
    "estimated_duration": 15,
    "is_required": true,
    "order_index": 0,
    "course_id": 1,
    "resources": [
      {
        "id": "1",
        "title": "Lesson Notes",
        "type": "pdf",
        "url": "https://example.com/notes.pdf",
        "file_size": 1024000
      }
    ],
    "quiz_questions": [
      {
        "id": "10",
        "question_type": "multiple-choice",
        "question_text": "What is a variable?",
        "question_data": {
          "options": ["A container for data", "A function", "A loop"],
          "correctOption": 0
        },
        "points": 1,
        "order_index": 0
      }
    ],
    "courses": {
      "id": 1,
      "title": "Introduction to Programming",
      "settings": {
        "requiresSequentialProgress": false
      }
    }
  }
}

Lesson Access Control

Access to lesson content is controlled by enrollment status:

Regular Users: Must be enrolled in the course to access any lesson
Admin/Instructor: Can access all lessons without enrollment

The API automatically checks enrollment status and returns a 403 Forbidden error if the user is not enrolled.

Lesson Content Types

Lessons support three main content types:

Video Lessons

Video lessons have a video_url field pointing to the video file. The URL may be transformed to use Azure Front Door CDN if enabled.

{
  "type": "video",
  "video_url": "https://cdn.example.com/videos/lesson-42.mp4",
  "estimated_duration": 15
}

Text Lessons

Text lessons contain HTML or markdown content in the text_content field.

{
  "type": "text",
  "text_content": "<h1>Introduction</h1><p>Welcome to this lesson...</p>",
  "estimated_duration": 10
}

Quiz Lessons

Quiz lessons contain questions from the normalized quiz_questions table. Questions support multiple types:

multiple-choice: Single correct answer from options
true-false: Boolean answer
fill-blank: Text input with correct answers
short-answer: Keyword-based evaluation
essay: Free-form text (manual grading)
matching: Match items from two lists

Quiz Question Structure

Quiz questions are stored in the quiz_questions table with the following structure:

Resources

Lessons can include downloadable resources linked through the lesson_resources junction table:

{
  "id": "1",
  "title": "Lesson Notes",
  "description": "Detailed notes for this lesson",
  "type": "pdf",
  "url": "https://s3.amazonaws.com/bucket/notes.pdf",
  "file_size": 1024000,
  "mime_type": "application/pdf",
  "download_count": 42
}

Error Codes

Status Code	Description
200	Success
401	Unauthorized - Authentication required
403	Forbidden - Not enrolled in course
404	Not Found - Lesson not found
500	Internal Server Error

​Get Lesson Details

​Path Parameters

​Response

​Example Request

​Example Response

​Lesson Access Control

​Lesson Content Types

​Video Lessons

​Text Lessons

​Quiz Lessons

​Quiz Question Structure

​Resources

​Error Codes

Get Lesson Details

Path Parameters

Response

Example Request

Example Response

Lesson Access Control

Lesson Content Types

Video Lessons

Text Lessons

Quiz Lessons

Quiz Question Structure

Resources

Error Codes