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

# Courses in a curriculum

> Fetches a list of Course objects for a specific curriculum.

A Course consists of a structured sequence of instructional content and activities designed to teach specific skills, knowledge, or competencies over a defined period. It typically encompasses multiple lesson groupings, lessons, and activities and aligns with curriculum standards and intended learning objectives for a particular grade level or subject area.

Use this endpoint when you need to:
- Discover available courses within a curriculum
- Get course metadata (name, description, grade levels, subject)
- Find course identifiers needed for other curriculum endpoints


> [!NOTE]
>
> `curriculumId` accepts `im360` (Illustrative Mathematics 360) and `ose` (OpenSciEd). OpenSciEd is a restricted-use dataset: a request whose credentials do not include the OpenSciEd Curriculum grant receives `403` from this endpoint. Licensed materials on each course are returned inline when the request's credentials cover them, and as empty arrays otherwise.


## OpenAPI

````yaml /knowledge-graph/using-knowledge-graph/rest-api/openapi.yaml get /courses
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:
  /courses:
    get:
      tags:
        - Curriculum
      summary: Courses in a curriculum
      description: >
        Fetches a list of Course objects for a specific curriculum.


        A Course consists of a structured sequence of instructional content and
        activities designed to teach specific skills, knowledge, or competencies
        over a defined period. It typically encompasses multiple lesson
        groupings, lessons, and activities and aligns with curriculum standards
        and intended learning objectives for a particular grade level or subject
        area.


        Use this endpoint when you need to:

        - Discover available courses within a curriculum

        - Get course metadata (name, description, grade levels, subject)

        - Find course identifiers needed for other curriculum endpoints
      operationId: listCourses
      parameters:
        - name: curriculumId
          in: query
          required: true
          description: The identifier for the curriculum to retrieve courses from.
          schema:
            $ref: '#/components/schemas/CurriculumIdENUM'
        - $ref: '#/components/parameters/LimitParam'
        - $ref: '#/components/parameters/CursorParam'
      responses:
        '200':
          description: Successfully retrieved list of courses
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/PaginatedResponse'
                  - type: object
                    properties:
                      data:
                        type: array
                        items:
                          $ref: '#/components/schemas/Course'
              example:
                data:
                  - identifier: im:b532b7df-4989-53a2-8f53-8dd829343423
                    name: Geometry
                    description: >-
                      For the first several units, students practice making
                      conjectures and observations. This begins with work on
                      compass and straightedge constructions. Students gradually
                      build up to writing formal proofs in narrative form
                      engaging in a cycle of conjecture, rough draft, peer
                      feedback, and final draft.
                    courseCode: im360:Geo
                    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/
                    dateCreated: '2020-06-25'
                  - identifier: im:1459a7dd-a3cd-5540-ada3-60553e2d5987
                    name: Integrated Math 2
                    description: >-
                      Students begin the course making observations about
                      triangles. Building from these observations, students
                      gather experimental information, develop conjectures,
                      write informal justifications, and then progress to
                      writing formal proofs using definitions, assertions, and
                      theorems developed in Math 1.
                    courseCode: im360:Math2
                    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/
                    dateCreated: '2023-08-22'
                pagination:
                  limit: 100
                  nextCursor: aW06MTQ1OWE3ZGQtYTNjZC01NTQwLWFkYTMtNjA1NTNlMmQ1OTg3
                  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'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          description: Unprocessable Entity - Invalid curriculumId value
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: ValidationError
                message: Input should be 'im360' or 'ose'
                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 courses
                requestId: req_12345
components:
  schemas:
    CurriculumIdENUM:
      type: string
      description: >
        Curriculum identifier. `im360` is Illustrative Mathematics 360, an open
        dataset. `ose` is OpenSciEd, a restricted-use dataset: its courses,
        lessons, activities, assessments, and materials are visible only to
        requests whose credentials include the OpenSciEd Curriculum dataset
        grant, and the curriculum entry points return 403 to any other request.
      enum:
        - im360
        - ose
    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'
    Course:
      type: object
      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
        description:
          type: string
          description: Description
        courseCode:
          type: string
          description: >-
            Unique identifier for the resource used by the course provider
            (e.g., "CS101" or "6.001")
        publisherIdentifier:
          type: string
          nullable: true
          description: Unique identifier for the resource used by the publisher
        academicSubject:
          $ref: '#/components/schemas/AcademicSubjectENUM'
        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
        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
        materials:
          type: array
          nullable: true
          default: []
          description: >-
            Licensed course-level materials (for example course guides and
            center materials) 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 course uses, including centers and their
            stages, that are visible to the request's credentials. Empty when
            none are visible.
          items:
            $ref: '#/components/schemas/InstructionalRoutine'
    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
    AcademicSubjectENUM:
      type: string
      description: >-
        Academic subject area. English Language Development and Spanish Language
        Development are the subjects of the language development standards
        frameworks (WIDA ELD 2020, Marco DALE, and the state ELD frameworks).
      enum:
        - English Language Arts
        - English Language Development
        - Mathematics
        - Science
        - Social Studies
        - Spanish Language Development
        - Other
    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
  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
  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
    Forbidden:
      description: >-
        No course in the requested curriculum is visible to the request's
        credentials. For a restricted-use curriculum such as OpenSciEd this
        means the calling project does not hold the dataset grant, or the API
        key has not been issued a grant token.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: ForbiddenError
            message: >-
              No courses in curriculum 'ose' are visible to this request's
              credentials.
            requestId: req_12345
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication

````