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

A lesson grouping organizes a set of related lessons within a curriculum. The naming and organizational level of lesson groupings vary across curricula - they may be called units, modules, chapters, sections, themes, etc. 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 /api-reference/knowledge-graph-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

    - **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:
  /lesson-groupings/{groupingId}:
    get:
      tags:
        - Curriculum
      summary: Lesson grouping by ID
      description: >
        Fetches detailed information about a specific lesson grouping.


        A lesson grouping organizes a set of related lessons within a
        curriculum. The naming and organizational level of lesson groupings vary
        across curricula - they may be called units, modules, chapters,
        sections, themes, etc. 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: The unique identifier of the lesson grouping
          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
        '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: >
        A lesson grouping organizes a set of related lessons within a
        curriculum. The 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: The unique identifier of the lesson grouping
        name:
          type: string
          description: The name of the lesson grouping
        ordinalName:
          type: string
          description: >-
            A label combining sequence number with descriptive text (e.g., "Unit
            1", "Chapter 2")
        groupName:
          type: string
          description: The type of grouping (e.g., "unit", "section", "module", "chapter")
        groupLevel:
          type: integer
          description: >-
            The nesting level of this grouping (0 = top level, 1 = nested once,
            etc.)
        position:
          type: integer
          description: The position of this grouping within its parent
        academicSubject:
          type: string
          description: The academic subject
        gradeLevel:
          type: array
          items:
            type: string
          description: Specifies the educational grades for which the grouping is intended
        author:
          type: string
          description: The author of the lesson grouping
        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 grouping
        audience:
          type: array
          items:
            type: string
          description: Specifies the intended audience for the lesson grouping
        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
        lmsLoadingGuidance:
          type: string
          description: LMS loading guidance for this lesson grouping
        isOptional:
          type: boolean
          description: Whether the lesson grouping is optional to complete
        courseCode:
          type: string
          description: The identifier for the course used by the course provider
        publisherIdentifier:
          type: string
          nullable: true
          description: The identifier assigned to this resource by its publisher
        timeRequired:
          type: string
          nullable: true
          description: >-
            Approximate or typical time it usually takes to work with or through
            the lesson grouping (ISO 8601 duration format)
        dateCreated:
          type: string
          format: date
          description: The date on which the lesson grouping was created
        attributionStatement:
          type: string
          description: A human-readable attribution statement for this lesson grouping
        lessons:
          type: array
          items:
            $ref: '#/components/schemas/Lesson'
          description: The lessons contained in this lesson grouping
    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
    Lesson:
      type: object
      description: >
        A lesson represents a focused instructional session within a larger
        curriculum structure, such as a lesson grouping or course, designed to
        achieve specific learning objectives.
      required:
        - identifier
        - author
        - provider
        - license
      properties:
        identifier:
          type: string
          description: The unique identifier of the lesson
        name:
          type: string
          description: The name of the lesson
        ordinalName:
          type: string
          description: >-
            A label combining sequence number with descriptive text (e.g.,
            "Lesson 1")
        position:
          type: integer
          description: The position of this lesson within its parent grouping
        academicSubject:
          type: string
          description: The academic subject
        gradeLevel:
          type: array
          items:
            type: string
          description: Specifies the educational grades for which the lesson is intended
        author:
          type: string
          description: The author of the lesson
        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 lesson
        audience:
          type: array
          items:
            type: string
          description: Specifies the intended audience for the lesson
        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
        lmsLoadingGuidance:
          type: string
          description: LMS loading guidance for this lesson
        isOptional:
          type: boolean
          description: Whether the lesson is optional to complete
        courseCode:
          type: string
          description: The identifier for the course used by the course provider
        publisherIdentifier:
          type: string
          nullable: true
          description: The identifier assigned to this resource by its publisher
        timeRequired:
          type: string
          description: >-
            Approximate or typical time it usually takes to work with or through
            the content (ISO 8601 duration format)
        dateCreated:
          type: string
          format: date
          description: The date on which the lesson was created
        attributionStatement:
          type: string
          description: A human-readable attribution statement for this lesson
  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.

````