> ## 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/entity-and-relationship-reference/academic-standards)
- [Framework adoption statuses](/knowledge-graph/entity-and-relationship-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

    - **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:
  /standards-frameworks:
    get:
      tags:
        - Standards frameworks
      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/entity-and-relationship-reference/academic-standards)

        - [Framework adoption
        statuses](/knowledge-graph/entity-and-relationship-reference/value-and-format-standards#adoptionstatusenum)
      operationId: listFrameworks
      parameters:
        - $ref: '#/components/parameters/JurisdictionParam'
        - $ref: '#/components/parameters/AcademicSubjectParam'
        - name: adoptionStatus
          in: query
          required: false
          description: Filter standards frameworks by their adoption status
          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
      description: Filter by jurisdiction (state/territory)
      schema:
        $ref: '#/components/schemas/JurisdictionENUM'
    AcademicSubjectParam:
      name: academicSubject
      in: query
      required: false
      description: Filter by academic subject area
      schema:
        $ref: '#/components/schemas/AcademicSubjectENUM'
    LimitParam:
      name: limit
      in: query
      required: false
      description: >-
        Maximum number of results to return. Default is 100. Maximum allowed is
        1000.
      schema:
        type: integer
        minimum: 1
        maximum: 1000
        default: 100
    CursorParam:
      name: cursor
      in: query
      required: false
      description: >-
        Cursor for pagination. Obtain this value from the 'nextCursor' field in
        the previous response. Omit 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: Generic cursor-based paginated response wrapper
      required:
        - data
        - pagination
      properties:
        data:
          type: array
          description: Array of result items
          items:
            type: object
        pagination:
          type: object
          description: Cursor-based pagination metadata
          required:
            - limit
            - hasMore
          properties:
            limit:
              type: integer
              description: Maximum number of results returned per page
            nextCursor:
              type: string
              nullable: true
              description: >-
                Cursor for fetching the next page. Null if no more results
                available. Pass this value as the 'cursor' parameter in the next
                request.
            hasMore:
              type: boolean
              description: >-
                Indicates whether there are more results available after this
                page
    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: >-
            The unique identifier for this standards framework in the Knowledge
            Graph system. This is a system-generated identifier that remains
            stable across data updates.
        caseIdentifierURI:
          type: string
          format: uri
          description: >-
            A URI referencing the equivalent standards framework in the CASE
            Network published by 1EdTech. This identifier can be used to trace
            the corresponding standards framework in the CASE dataset.
        caseIdentifierUUID:
          type: string
          format: uuid
          description: >-
            A UUID referencing the equivalent standards framework in the CASE
            Network published by 1EdTech. Use this identifier to query standards
            within this standards framework.
        name:
          type: string
          nullable: true
          description: >-
            The name or title of the standards framework (e.g., "Louisiana
            Student Standards for English Language Arts", "Iowa Core Mathematics
            Standards")
        description:
          type: string
          nullable: true
          description: >-
            A description of the standards framework providing additional
            context or information about the standards document
        jurisdiction:
          $ref: '#/components/schemas/JurisdictionENUM'
          description: >-
            The state, territory, country, or governing education agency
            responsible for publishing and adopting this standards framework
        academicSubject:
          $ref: '#/components/schemas/AcademicSubjectENUM'
          description: The academic subject area covered by this standards framework
        inLanguage:
          $ref: '#/components/schemas/LanguageENUM'
          description: The language of the standards framework content, in BCP 47 format
        adoptionStatus:
          $ref: '#/components/schemas/AdoptionStatusENUM'
          description: >-
            The adoption status of the standards framework within the
            jurisdiction. Indicates whether the standards framework has been
            formally adopted, is in development, or has been deprecated.
        dateModified:
          type: string
          format: date
          nullable: true
          description: >-
            The date on which this standards framework was most recently
            modified. Use this field to track when standards frameworks were
            last updated.
        notes:
          type: string
          nullable: true
          description: >-
            Optional field containing additional context, commentary,
            clarifications, or usage guidance about this standards framework
        author:
          type: string
          description: >-
            The author or creator of this standards framework, typically the
            organization that published the standards document
        provider:
          type: string
          description: >-
            The service provider or organization that makes this data available
            in the knowledge graph
        license:
          type: string
          format: uri
          description: A URL to the license document that applies to this content
        attributionStatement:
          type: string
          description: >-
            A textual credit that acknowledges the source and creator of this
            work, as required by the CC BY 4.0 license. If you display or
            redistribute this standards framework, you must include this
            attribution statement to comply with the license terms.
    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
    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
    LanguageENUM:
      type: string
      description: Language code in BCP 47 format
      enum:
        - en-US
        - es-US
  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.

````