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

# Standards frameworks

> Fetches a list of StandardsFramework objects representing complete academic standards documents. Each standards framework represents a complete standards document published by an official body like a state department of education.
This endpoint allows you to discover available standards frameworks and retrieve metadata about standards documents from different jurisdictions, subjects, and adoption statuses.

Use this endpoint when you need to:
- Discover available standards frameworks to query academic standards from
- Find standards framework UUIDs needed for the GET /academic-standards endpoint
- Browse standards frameworks by subject, jurisdiction, or adoption status
- Get standards framework metadata (title, adoption status, modification dates)

**Related topics:**
- [Understanding StandardsFramework vs StandardsFrameworkItem](/knowledge-graph/graph-reference/academic-standards)
- [Framework adoption statuses](/knowledge-graph/graph-reference/value-and-format-standards#adoptionstatusenum)




## OpenAPI

````yaml /api-reference/knowledge-graph-api/openapi.yaml get /standards-frameworks
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)

    - [Academic Standards](/knowledge-graph/graph-reference/academic-standards)

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

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

    - [Curriculum](/knowledge-graph/graph-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: 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:
  /standards-frameworks:
    get:
      tags:
        - Academic Standards
      summary: Standards frameworks
      description: >
        Fetches a list of StandardsFramework objects representing complete
        academic standards documents. Each standards framework represents a
        complete standards document published by an official body like a state
        department of education.

        This endpoint allows you to discover available standards frameworks and
        retrieve metadata about standards documents from different
        jurisdictions, subjects, and adoption statuses.


        Use this endpoint when you need to:

        - Discover available standards frameworks to query academic standards
        from

        - Find standards framework UUIDs needed for the GET /academic-standards
        endpoint

        - Browse standards frameworks by subject, jurisdiction, or adoption
        status

        - Get standards framework metadata (title, adoption status, modification
        dates)


        **Related topics:**

        - [Understanding StandardsFramework vs
        StandardsFrameworkItem](/knowledge-graph/graph-reference/academic-standards)

        - [Framework adoption
        statuses](/knowledge-graph/graph-reference/value-and-format-standards#adoptionstatusenum)
      operationId: listFrameworks
      parameters:
        - $ref: '#/components/parameters/JurisdictionParam'
        - $ref: '#/components/parameters/AcademicSubjectParam'
        - name: adoptionStatus
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/AdoptionStatusENUM'
        - $ref: '#/components/parameters/LimitParam'
        - $ref: '#/components/parameters/CursorParam'
      responses:
        '200':
          description: Successfully retrieved list of standards frameworks
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/PaginatedResponse'
                  - type: object
                    properties:
                      data:
                        type: array
                        items:
                          $ref: '#/components/schemas/StandardsFramework'
              example:
                data:
                  - identifier: 00bcc689-c7a6-5ef4-ac09-c868f9e25a06
                    caseIdentifierURI: >-
                      https://satchelcommons.com/ims/case/v1p0/CFDocuments/822e5a6e-bcb0-45b8-bb82-a2c88d5b4bb7
                    caseIdentifierUUID: 822e5a6e-bcb0-45b8-bb82-a2c88d5b4bb7
                    name: K-12 New Hampshire Social Studies Curriculum Framework
                    description: null
                    jurisdiction: New Hampshire
                    academicSubject: Social Studies
                    inLanguage: en-US
                    adoptionStatus: Implemented
                    dateCreated: null
                    dateModified: '2023-11-19'
                    notes: null
                    author: 1EdTech
                    provider: Learning Commons
                    license: https://creativecommons.org/licenses/by/4.0/
                    attributionStatement: >-
                      Knowledge Graph is provided by Learning Commons under the
                      CC BY-4.0 license. Learning Commons received state
                      standards and written permission under CC BY-4.0 from
                      1EdTech.
                  - identifier: 02575dee-30d0-50fd-b0e6-182da76f63a5
                    caseIdentifierURI: >-
                      https://satchelcommons.com/ims/case/v1p0/CFDocuments/50a88167-d6f5-41ea-a6c1-ee1ea83b6820
                    caseIdentifierUUID: 50a88167-d6f5-41ea-a6c1-ee1ea83b6820
                    name: 'North Carolina Standard Course of Study: Social Studies'
                    description: null
                    jurisdiction: North Carolina
                    academicSubject: Social Studies
                    inLanguage: en-US
                    adoptionStatus: Implemented
                    dateCreated: null
                    dateModified: '2024-04-08'
                    notes: null
                    author: 1EdTech
                    provider: Learning Commons
                    license: https://creativecommons.org/licenses/by/4.0/
                    attributionStatement: >-
                      Knowledge Graph is provided by Learning Commons under the
                      CC BY-4.0 license. Learning Commons received state
                      standards and written permission under CC BY-4.0 from
                      1EdTech.
                pagination:
                  limit: 100
                  nextCursor: >-
                    eyJpZGVudGlmaWVyIjogIjczYTJhNWY5LWRjOGUtNWE3Yi1iMzc4LTYzZGNmOWViZjFiNSJ9
                  hasMore: true
        '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
        '422':
          description: >-
            Unprocessable Entity - Invalid parameter values (e.g., enum value
            not in allowed list)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: ValidationError
                message: >-
                  Input should be 'Draft', 'Proposed', 'Adopted', 'Implemented',
                  or 'Retired'
                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 standards
                  frameworks
                requestId: req_12345
components:
  parameters:
    JurisdictionParam:
      name: jurisdiction
      in: query
      required: false
      schema:
        $ref: '#/components/schemas/JurisdictionENUM'
    AcademicSubjectParam:
      name: academicSubject
      in: query
      required: false
      schema:
        $ref: '#/components/schemas/AcademicSubjectENUM'
    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:
    AdoptionStatusENUM:
      type: string
      description: Adoption status of a standards framework
      enum:
        - Draft
        - Proposed
        - Adopted
        - Implemented
        - Retired
    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'
    StandardsFramework:
      type: object
      description: >
        Represents a complete academic standards document published by an
        official body like a state department of education.


        StandardsFramework serves as the root entity that organizes and
        contextualizes all standards within a given standards framework. Each
        standards framework represents a complete standards document with its
        own jurisdiction, subject area, and adoption status.
      required:
        - identifier
        - caseIdentifierUUID
        - author
        - provider
        - license
        - attributionStatement
      properties:
        identifier:
          type: string
          description: Unique identifier for the resource in Knowledge Graph
        caseIdentifierURI:
          type: string
          format: uri
          description: URI referencing the CASE Network equivalent
        caseIdentifierUUID:
          type: string
          format: uuid
          description: CASE Network UUID for the resource
        name:
          type: string
          nullable: true
          description: Name or title of the resource
        description:
          type: string
          nullable: true
          description: Description with additional context
        jurisdiction:
          $ref: '#/components/schemas/JurisdictionENUM'
        academicSubject:
          $ref: '#/components/schemas/AcademicSubjectENUM'
          description: Academic subject area
        inLanguage:
          $ref: '#/components/schemas/LanguageENUM'
          description: Language used in the resource (BCP 47 format)
        adoptionStatus:
          $ref: '#/components/schemas/AdoptionStatusENUM'
        dateModified:
          type: string
          format: date
          nullable: true
          description: Date last modified
        notes:
          type: string
          nullable: true
          description: >-
            (Optional) Additional context, commentary, clarifications, or usage
            guidance
        author:
          type: string
          description: Author or creator of the resource
        provider:
          type: string
          description: Source data provider for the resource
        license:
          type: string
          format: uri
          description: URL to the resource's license document
        attributionStatement:
          type: string
          description: >-
            Statement that acknowledges the resource's author and provider, as
            required by the CC BY 4.0 license
    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
    JurisdictionENUM:
      type: string
      description: US state, territory, or multi-state designation
      enum:
        - Alabama
        - Alaska
        - Arizona
        - Arkansas
        - California
        - Colorado
        - Connecticut
        - Delaware
        - Florida
        - Georgia
        - Hawaii
        - Idaho
        - Illinois
        - Indiana
        - Iowa
        - Kansas
        - Kentucky
        - Louisiana
        - Maine
        - Maryland
        - Massachusetts
        - Michigan
        - Minnesota
        - Mississippi
        - Missouri
        - Montana
        - Nebraska
        - Nevada
        - New Hampshire
        - New Jersey
        - New Mexico
        - New York
        - North Carolina
        - North Dakota
        - Ohio
        - Oklahoma
        - Oregon
        - Pennsylvania
        - Rhode Island
        - South Carolina
        - South Dakota
        - Tennessee
        - Texas
        - Utah
        - Vermont
        - Virginia
        - Washington
        - Washington, D.C.
        - West Virginia
        - Wisconsin
        - Wyoming
        - Multi-State
    AcademicSubjectENUM:
      type: string
      description: Academic subject area
      enum:
        - English Language Arts
        - Mathematics
        - Science
        - Social Studies
        - Other
    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
    LanguageENUM:
      type: string
      description: Language used in the resource (BCP 47 format)
      enum:
        - en-US
        - es-US
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication

````