> ## Documentation Index
> Fetch the complete documentation index at: https://docs.learningcommons.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Activities in a lesson

> Fetches a list of activities within a specific lesson.

An activity represents a discrete instructional task or exercise within a lesson, designed for students, teachers, or both. Activities are the building blocks of lessons and typically include specific tasks, exercises, discussions, or practice problems that help achieve the lesson's learning objectives.

Use this endpoint when you need to:
- Get all activities for a specific lesson
- Navigate the instructional components of a lesson
- Access activity metadata including timing, grouping, and submission requirements
- Build lesson plans or instructional sequences




## OpenAPI

````yaml /api-reference/knowledge-graph-api/openapi.yaml get /lessons/{lessonId}/activities
openapi: 3.0.3
info:
  title: Learning Commons Knowledge Graph REST API
  description: >
    REST API for accessing education knowledge graph data including academic
    standards, learning components, and curriculum information.


    **Key datasets:**

    - **Academic standards**: Official state standards from all 50 U.S. states
    sourced from 1EdTech's CASE Network

    - **Curriculum**: Structured course content including courses, lesson
    groupings (units, sections, modules), lessons, activities, and assessments

    - **Learning components**: Granular, teachable skills that break down broad
    standards into actionable instructional units

    - **Relationships**: Hierarchical and semantic connections between
    standards, learning components, and frameworks


    **Learn more:**

    - [Knowledge Graph
    Overview](/knowledge-graph/understanding-knowledge-graph/about-knowledge-graph)

    - [Academic Standards
    Dataset](/knowledge-graph/entity-and-relationship-reference/academic-standards)

    - [Learning Components
    Dataset](/knowledge-graph/entity-and-relationship-reference/learning-components)

    - [Quick Start Guide](/knowledge-graph/getting-started/quickstart)
  version: '0'
servers:
  - url: https://api.learningcommons.org/knowledge-graph/v0
    description: Production server
security:
  - ApiKeyAuth: []
tags:
  - name: Academic standards
    description: Academic standards operations
  - name: Curriculum
    description: Curriculum and course operations
  - name: Hierarchy
    description: Hierarchical navigation operations
  - name: Learning components
    description: Learning component operations
  - name: Learning progressions
    description: Learning progression and prerequisite relationships
  - name: Search
    description: Search and discovery operations
  - name: Standards crosswalks
    description: Standards crosswalk operations
  - name: Standards frameworks
    description: Standards frameworks operations
paths:
  /lessons/{lessonId}/activities:
    get:
      tags:
        - Curriculum
      summary: Activities in a lesson
      description: >
        Fetches a list of activities within a specific lesson.


        An activity represents a discrete instructional task or exercise within
        a lesson, designed for students, teachers, or both. Activities are the
        building blocks of lessons and typically include specific tasks,
        exercises, discussions, or practice problems that help achieve the
        lesson's learning objectives.


        Use this endpoint when you need to:

        - Get all activities for a specific lesson

        - Navigate the instructional components of a lesson

        - Access activity metadata including timing, grouping, and submission
        requirements

        - Build lesson plans or instructional sequences
      operationId: getLessonActivities
      parameters:
        - name: lessonId
          in: path
          required: true
          description: The unique identifier of the lesson
          schema:
            type: string
        - $ref: '#/components/parameters/LimitParam'
        - $ref: '#/components/parameters/CursorParam'
      responses:
        '200':
          description: Successfully retrieved list of activities
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/PaginatedResponse'
                  - type: object
                    properties:
                      data:
                        type: array
                        items:
                          $ref: '#/components/schemas/Activity'
              example:
                data:
                  - identifier: im:98928b4e-0183-5e0e-955d-230653db7332
                    name: Devices
                    ordinalName: Activity 1
                    position: 0
                    academicSubject: Mathematics
                    gradeLevel:
                      - high_school
                      - '9'
                      - '10'
                      - '11'
                      - '12'
                    author: Illustrative Mathematics
                    provider: Learning Commons
                    inLanguage: English
                    educationalUse: instruction
                    audience:
                      - Teacher
                      - Student
                      - Family
                    license: https://creativecommons.org/licenses/by-nc/4.0/
                    curriculumLabel: Warm-up
                    lmsLoadingGuidance: unspecified
                    isOptional: false
                    courseCode: im360:Alg1
                    timeRequired: PT5M
                    studentGroupingType: pair
                    dateCreated: '2020-06-25'
                pagination:
                  limit: 100
                  nextCursor: null
                  hasMore: false
        '400':
          description: Bad request - Invalid query parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: ValidationError
                message: Invalid query parameter value provided
                requestId: req_12345
        '404':
          description: Lesson not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: NotFoundError
                message: Lesson with identifier 'im:invalid-id' not found
                requestId: req_12345
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: InternalServerError
                message: An unexpected error occurred while retrieving activities
                requestId: req_12345
components:
  parameters:
    LimitParam:
      name: limit
      in: query
      required: false
      description: >-
        Maximum number of results to return. Default is 100. Maximum allowed is
        1000.
      schema:
        type: integer
        minimum: 1
        maximum: 1000
        default: 100
    CursorParam:
      name: cursor
      in: query
      required: false
      description: >-
        Cursor for pagination. Obtain this value from the 'nextCursor' field in
        the previous response. Omit for the first page.
      schema:
        type: string
  schemas:
    PaginatedResponse:
      type: object
      description: Generic cursor-based paginated response wrapper
      required:
        - data
        - pagination
      properties:
        data:
          type: array
          description: Array of result items
          items:
            type: object
        pagination:
          type: object
          description: Cursor-based pagination metadata
          required:
            - limit
            - hasMore
          properties:
            limit:
              type: integer
              description: Maximum number of results returned per page
            nextCursor:
              type: string
              nullable: true
              description: >-
                Cursor for fetching the next page. Null if no more results
                available. Pass this value as the 'cursor' parameter in the next
                request.
            hasMore:
              type: boolean
              description: >-
                Indicates whether there are more results available after this
                page
    Activity:
      type: object
      description: >
        An activity represents a discrete instructional task or exercise within
        a lesson, designed for students, teachers, or both.
      required:
        - identifier
        - author
        - provider
        - license
      properties:
        identifier:
          type: string
          description: The unique identifier of the activity
        name:
          type: string
          description: The name of the activity
        ordinalName:
          type: string
          description: >-
            A label combining sequence number with descriptive text (e.g.,
            "Activity 1")
        position:
          type: integer
          description: The position of this activity within its parent lesson
        academicSubject:
          type: string
          description: The academic subject
        gradeLevel:
          type: array
          items:
            type: string
          description: Specifies the educational grades for which the activity is intended
        author:
          type: string
          description: The author of the activity
        provider:
          type: string
          description: The service provider or service operator
        inLanguage:
          type: string
          description: The language of the content
        educationalUse:
          type: string
          description: The educational use of the activity
        audience:
          type: array
          items:
            type: string
          description: Specifies the intended audience for the activity
        license:
          type: string
          description: >-
            A license document that applies to this content, typically indicated
            by URL
        curriculumLabel:
          type: string
          description: >-
            A curriculum-specific categorization of the resource (e.g.,
            "Warm-up", "Cool-down", "Practice")
        lmsLoadingGuidance:
          type: string
          description: LMS loading guidance for this activity
        isOptional:
          type: boolean
          description: Whether the activity is optional to complete
        courseCode:
          type: string
          description: The identifier for the course used by the course provider
        timeRequired:
          type: string
          description: >-
            Approximate or typical time it usually takes to work with or through
            the activity (ISO 8601 duration format)
        studentGroupingType:
          type: string
          description: >-
            Describes intended grouping structure for student participation
            (e.g., "individual", "pair", "small_group", "whole_class")
        dateCreated:
          type: string
          format: date
          description: The date on which the activity was created
        attributionStatement:
          type: string
          description: A human-readable attribution statement for this activity
    Error:
      type: object
      description: Standard error response object returned for all error conditions
      required:
        - error
        - message
        - requestId
      properties:
        error:
          type: string
          description: >-
            A machine-readable error type identifier (e.g., ValidationError,
            NotFoundError, InternalServerError)
        message:
          type: string
          description: >-
            A human-readable error message that explains what went wrong and may
            include actionable guidance
        requestId:
          type: string
          description: >-
            A unique identifier for this request, useful for debugging and
            support
        details:
          type: object
          description: >-
            Optional additional details about the error, such as validation
            failures or field-specific issues
          additionalProperties: true
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        API key for authentication. Include your API key in the x-api-key header
        for all requests.

````