> ## 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 /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 US 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/schema-reference/standards)

    - [Learning
    Components](/knowledge-graph/schema-reference/learning-components)

    - [Standards crosswalks](/knowledge-graph/schema-reference/standards)

    - [Curriculum](/knowledge-graph/schema-reference/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
        '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
    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
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication

````