> ## 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. # Academic standards in a framework > Fetches a list of StandardsFrameworkItems for a specific standards framework. This endpoint retrieves academic standards from a single standards framework identified by its CASE UUID. You can further filter the results by grade level or classification type. This is useful when you need to work with academic standards from a specific state or jurisdiction. Use this endpoint when you need to: - Get all academic standards within a specific standards framework - Find academic standards for a particular grade level within a standards framework - Filter academic standards by subject area (e.g., only Mathematics academic standards) - Filter academic standards by their normalized classification (e.g., only instructional academic standards, not organizational groupings) - Retrieve a subset of a standards framework's academic standards for display or processing The endpoint returns paginated results. Use the `limit` and `cursor` parameters to control the number of results returned and navigate through large result sets. **Related topics:** - [Understanding StandardsFrameworkItem classifications](/knowledge-graph/entity-and-relationship-reference/value-and-format-standards#normalizedstatementtypeenum) ## OpenAPI ````yaml /api-reference/knowledge-graph-api/openapi.yaml get /academic-standards 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: /academic-standards: get: tags: - Academic standards summary: Academic standards in a framework description: > Fetches a list of StandardsFrameworkItems for a specific standards framework. This endpoint retrieves academic standards from a single standards framework identified by its CASE UUID. You can further filter the results by grade level or classification type. This is useful when you need to work with academic standards from a specific state or jurisdiction. Use this endpoint when you need to: - Get all academic standards within a specific standards framework - Find academic standards for a particular grade level within a standards framework - Filter academic standards by subject area (e.g., only Mathematics academic standards) - Filter academic standards by their normalized classification (e.g., only instructional academic standards, not organizational groupings) - Retrieve a subset of a standards framework's academic standards for display or processing The endpoint returns paginated results. Use the `limit` and `cursor` parameters to control the number of results returned and navigate through large result sets. **Related topics:** - [Understanding StandardsFrameworkItem classifications](/knowledge-graph/entity-and-relationship-reference/value-and-format-standards#normalizedstatementtypeenum) operationId: listAcademicStandards parameters: - name: standardsFrameworkCaseIdentifierUUID in: query required: true description: >- The CASE UUID of the standards framework to retrieve academic standards from. This identifies which state or jurisdictional standards framework to query. You must provide this parameter to scope the academic standards query to a specific standards framework. schema: type: string format: uuid - $ref: '#/components/parameters/GradeLevelParam' - $ref: '#/components/parameters/AcademicSubjectParam' - name: normalizedStatementType in: query required: false description: >- Filter standards by their normalized classification. Use this to retrieve only instructional standards (exclude organizational groupings) or to separate different types of framework elements. schema: $ref: '#/components/schemas/NormalizedStatementTypeENUM' - $ref: '#/components/parameters/LimitParam' - $ref: '#/components/parameters/CursorParam' responses: '200': description: Successfully retrieved list of standards content: application/json: schema: allOf: - $ref: '#/components/schemas/PaginatedResponse' - type: object properties: data: type: array items: $ref: '#/components/schemas/StandardsFrameworkItem' example: data: - identifier: 8e73cea8-f61d-5ac4-bcef-a84a331618d6 caseIdentifierURI: >- https://satchelcommons.com/ims/case/v1p0/CFItems/65b82d75-d7cc-11e8-824f-0242ac160002 caseIdentifierUUID: 65b82d75-d7cc-11e8-824f-0242ac160002 name: null statementCode: null description: Standards for Mathematical Practice statementType: null normalizedStatementType: null jurisdiction: Vermont academicSubject: Mathematics gradeLevel: - K - '1' - '2' - '3' - '4' - '5' - '6' - '7' - '8' - '9' - '10' - '11' - '12' inLanguage: en-US 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. pagination: limit: 1 nextCursor: >- eyJpZGVudGlmaWVyIjogIjhlNzNjZWE4LWY2MWQtNWFjNC1iY2VmLWE4NGEzMzE2MThkNiJ9 hasMore: true '400': description: >- Bad request - Missing required parameter or using invalid filter values content: application/json: schema: $ref: '#/components/schemas/Error' example: error: ValidationError message: >- Missing required parameter: standardsFrameworkCaseIdentifierUUID. Example: ?standardsFrameworkCaseIdentifierUUID=c6493f4d-d7cb-11e8-824f-0242ac160002 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 'Standard', 'Standard Grouping', or 'Other' 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 academic standards requestId: req_12345 components: parameters: GradeLevelParam: name: gradeLevel in: query required: false description: >- Filter by grade level. Can be specified multiple times to include multiple grades. schema: type: array items: $ref: '#/components/schemas/GradeLevelENUM' style: form explode: true example: - '9' - '10' 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: NormalizedStatementTypeENUM: type: string description: Normalized classification of a standards framework item enum: - Standard - Standard Grouping - Other 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 StandardsFrameworkItem: type: object description: > Represents an individual statement or structural element within a standards framework. StandardsFrameworkItems are the building blocks of academic standards documents. They can be: - **Learning expectations**: Normative statements that define what students should know or be able to do (e.g., standards, competencies, performance indicators) - **Organizational elements**: Structural groupings that organize learning expectations into coherent units (e.g., domains, strands, clusters, conceptual categories) Each item preserves the original statement text and metadata from state frameworks while including normalized properties that enable cross-framework queries and comparisons. Items maintain full traceability to their source in the CASE Network through CASE identifiers. required: - identifier - caseIdentifierUUID - author - provider - license - attributionStatement properties: identifier: type: string description: >- The unique identifier for this item in the Knowledge Graph system. This is a system-generated UUID that remains stable across data updates and can be used to reference this item in queries and relationships. caseIdentifierURI: type: string format: uri description: >- A URI referencing the equivalent item in the CASE Network published by 1EdTech. This identifier can be used to trace the corresponding standard in the CASE dataset. caseIdentifierUUID: type: string format: uuid description: >- A UUID referencing the equivalent item in the CASE Network published by 1EdTech. Use this identifier to trace the standard back to its authoritative source, establish equivalence with other systems using CASE data, or cross-reference with official state documentation that includes CASE identifiers. statementCode: type: string nullable: true description: >- A short, human-readable code that uniquely identifies this standard within its standards framework context. Typically alphanumeric (e.g., "3.NF.A.1", "A.1B", "MP1") and reflects the standards framework's internal coding scheme. This is the code educators use to reference standards in curriculum materials, lesson plans, and assessment systems. May be null for organizational groupings that don't have assigned codes. description: type: string nullable: true description: >- The full text of the standard or organizational element, describing what students should know or be able to do statementType: type: string nullable: true description: >- The original classification label used by the source standards framework to categorize this item (e.g., "Domain", "Cluster", "Strand", "Benchmark", "Practice Standard"). Unlike normalizedStatementType which standardizes across standards frameworks, this field preserves the exact terminology used in the state's official standards document, which can be helpful for maintaining consistency with state-specific materials and educator expectations. normalizedStatementType: $ref: '#/components/schemas/NormalizedStatementTypeENUM' description: >- A normalized classification that describes the broad functional role of this item, standardized across all standards frameworks regardless of how individual states label their standards. This enables cross-state queries like "find all actual standards" vs "find all organizational groupings". Use this field when you need consistent categorization across multiple jurisdictions. nullable: true jurisdiction: $ref: '#/components/schemas/JurisdictionENUM' description: >- The state, territory, country, or governing education agency responsible for publishing and adopting this standard. For U.S. state standards, this is the state name (e.g., "Iowa", "California"). This field is essential for filtering standards by location and understanding which standards apply to specific student populations or geographic regions. academicSubject: $ref: '#/components/schemas/AcademicSubjectENUM' description: The academic subject area for this standard gradeLevel: type: array nullable: true description: >- The educational grade level(s) for which this standard is intended. Values are strings to accommodate grade bands and special designations (e.g., "K", "PK", "9-12"). A standard may specify multiple individual grades or grade ranges. Use this field to filter standards appropriate for specific student grade levels. items: $ref: '#/components/schemas/GradeLevelENUM' inLanguage: $ref: '#/components/schemas/LanguageENUM' description: The language of the content, in BCP 47 format dateModified: type: string format: date nullable: true description: >- The date on which this element was most recently modified in the source system (CASE Network). Use this field to track when standards were last updated and identify the most current version of standards data. notes: type: string nullable: true description: >- Optional field containing additional context, commentary, clarifications, or usage guidance about this standard. May include information about prerequisite knowledge, connections to other standards, or implementation notes from the source framework. author: type: string description: >- The author or creator of this content, typically the organization that published the standards framework 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 standard, 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 GradeLevelENUM: type: string description: Educational grade level enum: - PK - K - '1' - '2' - '3' - '4' - '5' - '6' - '7' - '8' - '9' - '10' - '11' - '12' AcademicSubjectENUM: type: string description: Academic subject area enum: - English Language Arts - Mathematics - Science - Social Studies - Other 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 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. ````