> ## 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.

# Lesson grouping by ID

> Fetches detailed information about a specific lesson grouping.

Set of related lessons within a curriculum; naming and organizational level may vary across curricula (e.g., unit, module, chapter, section, theme). The `groupName` property indicates the specific type used by the curriculum.

Lesson groupings can be nested (e.g., units containing sections, chapters containing modules) as indicated by the `groupLevel` property, where 0 represents the top level.

Use this endpoint when you need to:
- Get complete metadata for a specific lesson grouping
- Retrieve organizational details (group name, level, position)
- Access curriculum-specific labeling and structure information
- Understand a lesson grouping's place in the course hierarchy




## OpenAPI

````yaml /knowledge-graph/using-knowledge-graph/rest-api/openapi.yaml get /lesson-groupings/{groupingId}
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:
  /lesson-groupings/{groupingId}:
    get:
      tags:
        - Curriculum
      summary: Lesson grouping by ID
      description: >
        Fetches detailed information about a specific lesson grouping.


        Set of related lessons within a curriculum; naming and organizational
        level may vary across curricula (e.g., unit, module, chapter, section,
        theme). The `groupName` property indicates the specific type used by the
        curriculum.


        Lesson groupings can be nested (e.g., units containing sections,
        chapters containing modules) as indicated by the `groupLevel` property,
        where 0 represents the top level.


        Use this endpoint when you need to:

        - Get complete metadata for a specific lesson grouping

        - Retrieve organizational details (group name, level, position)

        - Access curriculum-specific labeling and structure information

        - Understand a lesson grouping's place in the course hierarchy
      operationId: getLessonGroupingById
      parameters:
        - name: groupingId
          in: path
          required: true
          description: Unique identifier for the resource in Knowledge Graph
          schema:
            type: string
      responses:
        '200':
          description: Successfully retrieved lesson grouping
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LessonGrouping'
              example:
                identifier: im:857861da-50c7-5302-b288-d0b2d4f82188
                name: Complex Numbers
                ordinalName: Unit 6
                groupName: unit
                groupLevel: 0
                position: 5
                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: Unit
                lmsLoadingGuidance: unspecified
                isOptional: true
                courseCode: im360:Math2
                dateCreated: '2023-08-22'
        '400':
          description: Bad request - Invalid groupingId format
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: ValidationError
                message: Invalid grouping identifier format
                requestId: req_12345
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          description: Lesson grouping not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: NotFoundError
                message: Lesson grouping 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 the lesson
                  grouping
                requestId: req_12345
components:
  schemas:
    LessonGrouping:
      type: object
      description: >
        Set of related lessons within a curriculum; naming and organizational
        level may vary across curricula (e.g., unit, module, chapter, section,
        theme)
      required:
        - identifier
        - groupName
        - groupLevel
        - 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., "Unit 1",
            "Chapter 2")
        groupName:
          type: string
          description: Type of grouping (e.g., "unit", "section", "module", "chapter")
        groupLevel:
          type: integer
          description: >-
            Nesting level of this grouping (0 = top level, 1 = nested once,
            etc.)
        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
        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
        publisherIdentifier:
          type: string
          nullable: true
          description: Unique identifier for the resource used by the publisher
        timeRequired:
          type: string
          nullable: true
          description: >-
            Approximate amount of time required to work through the resource
            (ISO 8601 duration format)
        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
        lessons:
          type: array
          items:
            $ref: '#/components/schemas/Lesson'
          description: Lessons contained in this resource
        materials:
          type: array
          nullable: true
          default: []
          description: >-
            Licensed materials attached to this lesson grouping that are visible
            to the request's credentials. Empty when none are visible.
          items:
            $ref: '#/components/schemas/Material'
        glossaryTerms:
          type: array
          nullable: true
          default: []
          description: >-
            Glossary terms this lesson grouping references that are visible to
            the request's credentials. Empty when none are visible.
          items:
            $ref: '#/components/schemas/GlossaryTerm'
    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
    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'
    Lesson:
      type: object
      description: >
        Focused instructional session within a curriculum structure (e.g.,
        lesson grouping or course) designed to achieve specific learning
        objectives
      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., "Lesson 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
        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
        publisherIdentifier:
          type: string
          nullable: true
          description: Unique identifier for the resource used by the publisher
        timeRequired:
          type: string
          description: >-
            Approximate amount of time required to work through the resource
            (ISO 8601 duration format)
        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 lesson that are visible to the
            request's credentials. Empty when none are visible; null only when
            the lesson is nested inside a lesson grouping response, where
            materials are not fetched.
          items:
            $ref: '#/components/schemas/Material'
        glossaryTerms:
          type: array
          nullable: true
          default: []
          description: >-
            Glossary terms this lesson references that are visible to the
            request's credentials. Empty when none are visible; null only on
            lessons nested inside a lesson grouping response.
          items:
            $ref: '#/components/schemas/GlossaryTerm'
        classroomMaterials:
          type: array
          nullable: true
          default: []
          description: >-
            Classroom materials (supplies) this lesson uses that are visible to
            the request's credentials. Empty when none are visible; null only on
            lessons nested inside a lesson grouping response.
          items:
            $ref: '#/components/schemas/ClassroomMaterial'
    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
    GlossaryTerm:
      type: object
      description: >
        A curriculum glossary term referenced by a lesson or lesson grouping.
        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 glossary term
        name:
          type: string
          description: The term
        description:
          type: string
          description: The definition of the term, as markdown
        curriculumLabel:
          type: string
          description: >-
            A curriculum-specific categorization of the resource (e.g.,
            "Glossary")
        educationalUse:
          type: string
          description: The educational use of the glossary term
        audience:
          type: array
          items:
            type: string
          description: Specifies the intended audience for the glossary term
        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 glossary term
        author:
          type: string
          description: The author of the glossary term
        provider:
          type: string
          description: The service provider or service operator
        license:
          type: string
          description: The license terms that apply to this glossary term
        attributionStatement:
          type: string
          description: A human-readable attribution statement for this glossary term
    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

````