> ## 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 /knowledge-graph/using-knowledge-graph/rest-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

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

    - **Standards crosswalks**: Connections between standards and frameworks

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


    **Learn more:**

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

    - [Standards](/knowledge-graph/schemas/standards)

    - [Learning components](/knowledge-graph/schemas/learning-components)

    - [Standards crosswalks](/knowledge-graph/schemas/standards)

    - [Curriculum](/knowledge-graph/schemas/curriculum)

    - [Quickstart](/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 operations
  - name: Durable skills
    description: Durable skills frameworks and skills operations
  - name: Hierarchy
    description: Hierarchical navigation operations
  - name: Learning components
    description: Learning components operations
  - name: Learning progressions
    description: Learning progressions operations
  - name: Search
    description: Search and discovery operations
  - name: Standards Crosswalks
    description: Standards crosswalks 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: Unique identifier for the resource in Knowledge Graph
          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
        '401':
          $ref: '#/components/responses/Unauthorized'
        '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
      schema:
        type: integer
        minimum: 1
        maximum: 1000
        default: 100
    CursorParam:
      name: cursor
      in: query
      required: false
      description: >-
        Pagination cursor obtained from the `nextCursor` field in a previous
        response (not needed for the first page)
      schema:
        type: string
  schemas:
    PaginatedResponse:
      type: object
      description: Cursor-based paginated response
      required:
        - data
        - pagination
      properties:
        data:
          type: array
          description: Array of result items
          items:
            type: object
        pagination:
          $ref: '#/components/schemas/Pagination'
    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: Unique identifier for the resource in Knowledge Graph
        name:
          type: string
          description: Name or title of the resource
        ordinalName:
          type: string
          description: Label with sequence number and descriptive text (e.g., "Activity 1")
        position:
          type: integer
          description: Position of the resource within its parent
        academicSubject:
          type: string
          description: Academic subject
        gradeLevel:
          type: array
          items:
            $ref: '#/components/schemas/GradeLevelENUM'
        author:
          type: string
          description: Author or creator of the resource
        provider:
          type: string
          description: Source data provider for the resource
        inLanguage:
          type: string
          description: Language used in the resource (BCP 47 format)
        educationalUse:
          type: string
          description: Educational use of the resource
        audience:
          type: array
          items:
            type: string
          description: Intended audience of the resource
        license:
          type: string
          description: URL to the resource's license document
        curriculumLabel:
          type: string
          description: >-
            Curriculum-specific categorization of the resource (e.g., "Warm-up",
            "Cool-down", "Practice")
        lmsLoadingGuidance:
          type: string
          description: LMS loading guidance for the resource
        isOptional:
          type: boolean
          description: Whether the resource is optional to complete
        courseCode:
          type: string
          description: Unique identifier for the resource used by the course provider
        timeRequired:
          type: string
          description: >-
            Approximate amount of time required to work through the resource
            (ISO 8601 duration format)
        studentGroupingType:
          type: string
          description: >-
            Grouping structure for student participation (e.g., "individual",
            "pair", "small_group", "whole_class")
        dateCreated:
          type: string
          format: date
          description: Date created
        attributionStatement:
          type: string
          description: >-
            Statement that acknowledges the resource's author and provider, as
            required by the CC BY 4.0 license
        materials:
          type: array
          nullable: true
          default: []
          description: >-
            Licensed materials attached to this activity that are visible to the
            request's credentials. Empty when none are visible.
          items:
            $ref: '#/components/schemas/Material'
        instructionalRoutines:
          type: array
          nullable: true
          default: []
          description: >-
            Instructional routines this activity uses that are visible to the
            request's credentials. Empty when none are visible.
          items:
            $ref: '#/components/schemas/InstructionalRoutine'
        classroomMaterials:
          type: array
          nullable: true
          default: []
          description: >-
            Classroom materials (supplies) this activity uses that are visible
            to the request's credentials. Empty when none are visible.
          items:
            $ref: '#/components/schemas/ClassroomMaterial'
    Error:
      type: object
      description: Standard error response object returned for all error conditions
      required:
        - error
        - message
        - requestId
      properties:
        error:
          type: string
          description: >-
            Machine-readable error type identifier (e.g., `ValidationError`,
            `NotFoundError`, `InternalServerError`)
        message:
          type: string
          description: >-
            Human-readable error message that explains what went wrong and may
            include actionable guidance
        requestId:
          type: string
          description: Unique identifier for this request (for debugging and support)
        details:
          type: object
          description: >-
            Optional additional details about the error, such as validation
            failures or field-specific issues
          additionalProperties: true
    Pagination:
      type: object
      description: Cursor-based pagination metadata
      required:
        - limit
        - hasMore
      properties:
        limit:
          type: integer
          description: Maximum number of results to return per page
        nextCursor:
          type: string
          nullable: true
          description: >-
            Cursor for fetching the next page of results in your next request
            (`null` if there are no more results)
        hasMore:
          type: boolean
          description: Whether there are more results after this page
    GradeLevelENUM:
      type: string
      description: Educational grade level that the resource is intended for
      enum:
        - PK
        - K
        - '1'
        - '2'
        - '3'
        - '4'
        - '5'
        - '6'
        - '7'
        - '8'
        - '9'
        - '10'
        - '11'
        - '12'
    Material:
      type: object
      description: >
        A licensed instructional material attached to a curriculum resource:
        lesson narratives, handouts, course guides, assessment items, and their
        student or family variants. Materials are restricted-use content. A
        request sees only the materials its credentials cover; the arrays that
        carry them are empty otherwise. `content` is markdown.
      required:
        - identifier
        - name
        - author
        - provider
        - license
      properties:
        identifier:
          type: string
          description: The unique identifier of the material
        name:
          type: string
          description: The name of the material
        ordinalName:
          type: string
          nullable: true
          description: >-
            A label combining sequence number with descriptive text (e.g.,
            "Lesson 4", "Material 1")
        materialType:
          type: string
          description: >-
            The role of the material within its parent (e.g., "Core",
            "Supporting", "Reference")
        educationalUse:
          type: string
          description: >-
            The educational use of the material (e.g., "Instruction",
            "Assessment")
        audience:
          type: array
          items:
            type: string
          description: >-
            Specifies the intended audience for the material (e.g., "Teacher",
            "Student", "Family")
        academicSubject:
          type: string
          description: The academic subject
        inLanguage:
          type: string
          description: The language of the content
        courseCode:
          type: string
          nullable: true
          description: >-
            The identifier for the course used by the course provider; absent on
            center and stage materials
        author:
          type: string
          description: The author of the material
        provider:
          type: string
          description: The service provider or service operator
        license:
          type: string
          description: The license terms that apply to this material
        attributionStatement:
          type: string
          description: A human-readable attribution statement for this material
        content:
          type: string
          description: The body of the material, as markdown
    InstructionalRoutine:
      type: object
      description: >
        A named instructional routine used by a course or activity, including
        K-5 centers and their stages. Restricted-use content, visible only to
        requests whose credentials cover it.
      required:
        - identifier
        - name
        - author
        - provider
        - license
      properties:
        identifier:
          type: string
          description: The unique identifier of the instructional routine
        name:
          type: string
          description: The name of the instructional routine
        ordinalName:
          type: string
          nullable: true
          description: >-
            A label combining sequence number with descriptive text (e.g.,
            "Stage 2"); stages carry one, routines and centers do not
        position:
          type: integer
          nullable: true
          description: The position of this routine within its parent, where applicable
        description:
          type: string
          description: How the routine is run, as markdown
        curriculumLabel:
          type: string
          description: >-
            A curriculum-specific categorization of the resource (e.g.,
            "Instructional Routine", "Center", "Stage")
        gradeLevel:
          type: array
          nullable: true
          items:
            type: string
          description: Specifies the educational grades for which the routine is intended
        isOptional:
          type: boolean
          description: Whether the routine is optional
        educationalUse:
          type: string
          description: The educational use of the routine
        audience:
          type: array
          items:
            type: string
          description: Specifies the intended audience for the routine
        academicSubject:
          type: string
          description: The academic subject
        inLanguage:
          type: string
          description: The language of the content
        lmsLoadingGuidance:
          type: string
          description: LMS loading guidance for this routine
        dateCreated:
          type: string
          format: date
          description: The date on which the routine was created
        author:
          type: string
          description: The author of the routine
        provider:
          type: string
          description: The service provider or service operator
        license:
          type: string
          description: The license terms that apply to this routine
        attributionStatement:
          type: string
          description: A human-readable attribution statement for this routine
    ClassroomMaterial:
      type: object
      description: >
        A physical classroom material or supply a lesson or activity uses (e.g.,
        rulers, thermometers). Restricted-use content, visible only to requests
        whose credentials cover it.
      required:
        - identifier
        - name
        - author
        - provider
        - license
      properties:
        identifier:
          type: string
          description: The unique identifier of the classroom material
        name:
          type: string
          description: The name of the classroom material
        description:
          type: string
          nullable: true
          description: Quantity or preparation notes, as markdown
        curriculumLabel:
          type: string
          description: >-
            A curriculum-specific categorization of the resource (e.g.,
            "Required Material")
        educationalUse:
          type: string
          description: The educational use of the classroom material
        audience:
          type: array
          items:
            type: string
          description: Specifies the intended audience for the classroom material
        academicSubject:
          type: string
          description: The academic subject
        inLanguage:
          type: string
          description: The language of the content
        lmsLoadingGuidance:
          type: string
          nullable: true
          description: LMS loading guidance for this classroom material
        author:
          type: string
          description: The author of the classroom material
        provider:
          type: string
          description: The service provider or service operator
        license:
          type: string
          description: The license terms that apply to this classroom material
        attributionStatement:
          type: string
          description: A human-readable attribution statement for this classroom material
  responses:
    Unauthorized:
      description: >-
        Missing or invalid credentials. The same body is returned whatever the
        cause.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: UnauthorizedError
            message: Missing or invalid bearer token
            requestId: req_12345
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication

````