CASE v1.1 Specification
Spec Version 1.1
Document Version: | 1 |
Date Issued: | January 24th, 2025 |
Status: | This document is made available for adoption by the public community at large. |
This version: | https://www.imsglobal.org/spec/CASE/v1p1/main/ |
Latest version: | https://www.imsglobal.org/spec/CASE/latest/main/ |
Errata: | https://www.imsglobal.org/spec/CASE/v1p1/errata/ |
IPR and Distribution Notice
Recipients of this document are requested to submit, with their comments, notification of any relevant patent claims or other intellectual property rights of which they may be aware that might be infringed by any implementation of the specification set forth in this document, and to provide supporting documentation.
1EdTech takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; neither does it represent that it has made any effort to identify any such rights. Information on 1EdTech's procedures with respect to rights in 1EdTech specifications can be found at the 1EdTech Intellectual Property Rights webpage: https://www.1edtech.org/sites/default/files/media/docs/2023/imsipr_policyFinal.pdf .
The following participating organizations have made explicit license commitments to this specification:
Org name | Date election made | Necessary claims | Type |
---|---|---|---|
UNICON INC. | January 14, 2025 | No | RF RAND (Required & Optional Elements) |
Common Good Learning Tools | January 15, 2025 | No | RF RAND (Required & Optional Elements) |
Infinite Campus | January 23, 2025 | No | RF RAND (Required & Optional Elements) |
Use of this specification to develop products or services is governed by the license with 1EdTech found on the 1EdTech website: https://www.1edtech.org/standards/specification-license.
Permission is granted to all parties to use excerpts from this document as needed in producing requests for proposals.
The limited permissions granted above are perpetual and will not be revoked by 1EdTech or its successors or assigns.
THIS SPECIFICATION IS BEING OFFERED WITHOUT ANY WARRANTY WHATSOEVER, AND IN PARTICULAR, ANY WARRANTY OF NONINFRINGEMENT IS EXPRESSLY DISCLAIMED. ANY USE OF THIS SPECIFICATION SHALL BE MADE ENTIRELY AT THE IMPLEMENTER'S OWN RISK, AND NEITHER THE CONSORTIUM, NOR ANY OF ITS MEMBERS OR SUBMITTERS, SHALL HAVE ANY LIABILITY WHATSOEVER TO ANY IMPLEMENTER OR THIRD PARTY FOR ANY DAMAGES OF ANY NATURE WHATSOEVER, DIRECTLY OR INDIRECTLY, ARISING FROM THE USE OF THIS SPECIFICATION.
Public contributions, comments and questions should be directed to support@1edtech.org .
© 2025 1EdTech™ Consortium, Inc. All Rights Reserved.
Trademark information: https://www.1edtech.org/about/legal
Abstract
The 1EdTech Competencies and Academic Standards Exchange® (CASE®) v1.1 standard facilitates the exchange of information about academic learning standards, competencies, and skills between different educational applications and tools, for the specific needs of K-12, Higher Education, and the Workforce. CASE can also transmit information about rubrics, performance task criteria, and associations across frameworks, so frameworks and items can be related and aligned. The applications and tools involved in the exchange typically includes: Learning Management Systems (LMSs), Learning Object Repositories, (LORs), Student Information Systems (SISs), assessment tools, curriculum management, digital credentialing, hiring platforms, etc.
The 1EdTech Competencies and Academic Standards Exchange® (CASE®) 1.1 specification defines how systems can exchange academic standards, competencies, and/or skills in a standardized way. The goal for CASE is to replace the current ways of documenting a learning standard and competency, typically a PDF or HTML document, by a method that is both human and machine-readable. These digital versions are called CASE Frameworks. This CASE 1.1 specification makes it possible to electronically exchange this information between applications and tools. The applications and tools can access the data, that has globally unique identifiers (GUIDs) to meta-tag learning resources and/or associate those academic standards, competencies, and/or skills to other CASE frameworks, digital credentials, and other external standards bodies.
This document is released for public adoption and implementation of the CASE Service 1.1 specification. Public contributions, feedback on adoption of the specification, comments and questions can be emailed to: support@1edtech.org
If you have questions or need help with implementing CASE or achieving conformance certification, here are some available resources:
- CASE Support: email support@1edtech.org - for all parties interested in CASE
- CASE Project Group Forum - for 1EdTech Contributing Members
- CASE Support: email support@1edtech.org - for CASE Alliance, Affiliate, and Contributing Members
- CASE Developer Webpage - information and resources on the 1EdTech CASE webpage, such as specifications and other technical documents
- 1EdTech Contributing Members have access to private GitHub repositories and a Slack channel for CASE discussions and collaborations.
- Contact a 1EdTech staff member to gain access or email: support@1edtech.org
1EdTech offers a process for testing the conformance of products using the 1EdTech certification test suite. Certification designates passing a set of tests that verify the standard has been implemented correctly and guarantees a product’s interoperability across hundreds of other certified products. The CASE 1.1 Conformance Certification Guide CASE-1.1 provides details about the testing process, requirements, and how to get started.
Conformance certification is much better than claims of “compliance," since the only way 1EdTech can guarantee interoperability is by obtaining certification for the latest version of the standard. Only products listed in the official 1EdTech TrustEd Apps Directory can claim conformance certification. 1EdTech certification provides the assurance that a solution will integrate securely and seamlessly into an institution's digital learning ecosystem.
In order to become certified, a paid 1EdTech membership is necessary. Here's why: while conformance certification provides a "seal" for passing prescribed tests it is much more than that. It is a commitment by a supplier to the 1EdTech community for continuous support for achieving "plug and play" integration. Certification implies ongoing community commitment to resolve problems, revise implementations and retest as need. For that reason, only 1EdTech Contributing Members, Affiliate Members, and CASE Alliance members are eligible to apply for conformance certification. Details and benefits of membership are listed at https://www.imsglobal.org/imsmembership.html.
As well as sections marked as non-normative, all authoring guidelines, diagrams, examples, and notes in this specification are non-normative. Everything else in this specification is normative.
The key words MAY, MUST, MUST NOT, OPTIONAL, RECOMMENDED, REQUIRED, SHALL, SHALL NOT, SHOULD, and SHOULD NOT in this document are to be interpreted as described in RFC2119.
An implementation of this specification that fails to implement a MUST/REQUIRED/SHALL requirement or fails to abide by a MUST NOT/SHALL NOT prohibition is considered nonconformant. SHOULD/SHOULD NOT/RECOMMENDED statements constitute a best practice. Ignoring a best practice does not violate conformance but a decision to disregard such guidance should be carefully considered. MAY/OPTIONAL statements indicate that implementers are entirely free to choose whether or not to implement the option.
The 1EdTech TrustEd Apps Directory is the official listing of products that have passed 1EdTech's conformance certification testing. Products that are listed in this directory are guaranteed to meet the 1EdTech standards for which they have passed testing. If you experience an integration issue with a product listed here, 1EdTech will work with the supplier to resolve the problem. If a product is NOT listed here it has either not passed 1EdTech testing or its certification has expired.
Section | Description |
---|---|
API | Application Programming Interface |
IUT | Implementation Under Test |
JSON | Java Script Object Notation |
CASE | Competencies and Academic Standards Exchange |
REST | Representation State Transfer |
GUID | Globally Unique Identifier |
Framework | For CASE, a digital version of a hierarchical PDF, Spreadsheet, or manually created document |
CASE Issuer | Owner or Official Entity who is the owner of the academic standards, competencies, or skills |
CASE Provider | Provides or publishs the academic standards, competencies, or skills in the CASE format |
CASE Consumer | Consumes or ingests the academic standards, competencies, or skills, from a CASE Provider, in the CASE format |
The Competencies and Academic Standards Exchange (CASE) 1.1 Standard documentation is a service. This service is accomplished via a data model as represented in JSON, and exchanged via a REST API. For these REST implementations, there is an information model document and a REST binding document. The information model documents describe the data dictionary and logical data model for the service. The REST binding documents describe the serialization and endpoint definitions for the service.
This document is the Competencies and Academic Standards Exchange (CASE) Service 1.1 Specification document and is used to define how a product can be certified as 1EdTech CASE 1.1 Service Provider or Consumer. The formal definition of the CASE Service 1.1 is supplied in the following documents:
- 1EdTech Competencies and Academic Standards Exchange (CASE) Service 1.1 [CASE-SM-11] - the description of the Information Model for the service;
- 1EdTech Competencies and Academic Standards Exchange (CASE) Service REST/JSON Binding v1.1 [CASE-BD-11] - the description of the REST/- CASE 1.1 JSON binding, including the OpenAPI description, realization of the Information Model.
- CASE 1.1 OpenAPI (JSON/YAML) v2.0/v3.0
- CASE 1.1 JSON Schema files
- Competencies and Academic Standards Exchange Best Practice and Implementation Guide v1.1
- Competencies and Academic Standards Exchange (CASE) Service v.1.1: Conformance and Certification
Like all 1EdTech specifications, the CASE specification describes data in motion, i.e. the exchange of information achieved using agreed interoperability. In CASE 1.1, the information that is being exchanged is contained in these groups:
- Academic Standards - the academic learning standards published by the CASE Provider, for the CASE Issuer, or the official entity;
- Competencies - the competencies published by the CASE Provider, for the CASE Issuer, or the official entity;
- Skills- the set of resources that are required for a class and/or a course, published by the CASE Provider, for the CASE Issuer, or the official entity
CASE 1.1 serves as a minor upgrade to CASE 1.0. CASE 1.1 still consists of two distinct services that were available in previous version, which are: CASE Provider and CASE Consumer. The list new features supported in CASE 1.1 include:
The goal for CASE 1.1 is to release a small update to address active integration concerns as well as provide clarity for implementing organizations. The sections below describe an overview of the new API path and each new feature. The new API path and any added features will be checked during the review process for CASE 1.1 Provider and CASE 1.1 Consumer certifications.
API Path Change:
- The API endpoint path for CASE 1.1 changes the BASEURL to /ims/case/v1p1.
New fields and model changes:
These are brief descriptions of the new fields. See the sections below for more thorough descriptions and implementation guidance.
New Fields | Description |
---|---|
API | Application Programming Interface |
CFDocument.frameworkType | Specify the framework type of the CFDocument |
CFDocument.caseVersion | The CASE version for the CFDocument. Currently, the only expected value is 1.1 since this field does not exist for CASE 1.0. |
CFItem.subject | Allow individual items to have different subjects from the main document |
CFItem.subjectURI | Allow individual items to have different subjects from the main document |
CFAssociation.notes | Allow notes for associations |
CFAssociation.originNodeURI.targetType | Specify the type of the referenced association |
CFAssociation.destinationNodeURI.targetType | Specify the type of the referenced association |
CFAssociation Types | Added isTranslationOf |
Extensions | CFItem, CFDocument, and CFAssociation JSON entities can now include an extensions field, which can include additional sub-fields that are not included in the defined CASE information model |
Framework Types
CFDocument now has an optional field frameworkType. This allows framework creators to indicate what type of framework this is, for example course codes.
- With the release of CASE 1.1, course codes is the only official type.
- For CASE 1.1 framework types and their data will not be certified.
Associations Pointing to non-CASE Frameworks:
CFAssociations now allow the originNodeURI and destinationNodeURI to point to non-CASE frameworks. This is a large change since it changes how CASE consumers process associations since it can no longer be assumed the target is a CASE object. To help guide implementors the field targetType was added to these association pointers.
- The default value is CASE. This is intended to be an open vocabulary with a shared set defined by the CASE workgroup over time.
Rich text with Markdown and LaTeX:
Many item statements need to utilize basic formatting and support for math and other rendered text. In CASE 1.1, many fields MAY now contain Markdown and math-related LaTeX. While it is possible to display this content without rendering the Markdown/LaTeX, all systems that display CASE items SHOULD render the Markdown and LaTeX, e.g. using JavaScript libraries such as Marked and KaTeX or MathJax.
List of fields that now support Markdown and LaTeX:
- CFItem.fullStatement
- CFItem.notes
- CFAssociation.notes
- CFDocument.notes
- All description fields
- See the best practices section on Markdown and Latex and the appendix Examples of rendered Markdown and LaTeX for more guidance and examples of how Markdown and LaTeX should be properly rendered.
Extensions to CFItems and other entities
The CASE 1.0 spec explicitly disallowed “proprietary data elements” in CASE JSON. However, In CASE 1.1, CFItems, CFDocuments, CFAssociations, and other entities MAY include an extensions field, which can in turn include sub-fields for names and values that are outside the spec. A system consuming CASE can simply ignore the entire extensions field, and/or any extension sub-fields, that the system doesn’t “know” or “care” about. By nesting all custom data in an extensions field, we avoid namespace collisions with field names that may be introduced in future CASE versions. Best practice is to use camelCase for field names, for consistency with official CASE fields.
CASE defines two roles, a Provider and a Consumer. Technical administrators or other users will export from the Provider system such as a student information system and import to a consumer system, such as an LMS or a digital text via REST API-based products but users are not handling files directly since the exchange is system-to-system. Users can also download CSV or JSON files from a CASE Provider's application, if agreed upon.
When selecting products, it is very important to understand what CASE product type you are considering purchasing. Will the product be a CASE 1.1 Provider or a CASE 1.1 Consumer? Or is the product performing an Aggregator service, which is a Consumer of data from one system and Provider of that data to another system, or a Contractor who will build your CASE implementation? An Aggregator service or Contractor usually performs additional value-added services to help make the creation and exchange of academic standards, competencies, or skills in multiple platforms easier and more efficient, in some cases. Because of their intermediary role, to be compliant, Aggregator product types and Contractors who build CASE frameworks must be certified as either/or both CASE 1.1 Consumers and CASE 1.1 Providers.
This section is non-normative.
Version | Release Date | Comments |
---|---|---|
CASE 1.1 Final Release | February 28th, 2024 | CASE 1.1 first Final Release. The first formal Candidate Final Release that is ready for public adoption and implementation. |
CASE 1.1 Final Release | February 28th, 2024 | First Release of CASE 1.1 Final Release. Document location: https://www.imsglobal.org/case/ |
Number | Section | Description |
---|---|---|
1. | [CASE, 17a] | 1EdTech Competencies and Academic Standards Exchange (CASE) Service 1.1 Candidate Final Document, G.Nadeau, R.Grogan, C.Smythe and J.Hobson, 1EdTech Learning Consortium Inc., July 2017, https://www.imsglobal.org/sites/default/files/spec/case/v1p1/information_model/caseservicev1p1_infomodelv1p0.html. |
2. | [CASE, 17b] | 1EdTech Competencies and Academic Standards Exchange (CASE) Service 1.1 REST/JSON Binding Candidate Final Document, G.Nadeau, R.Grogan, C.Smythe and J.Hobson, IMS Global Learning Consortium Inc., July 2017, https://www.imsglobal.org/sites/default/files/spec/case/v1p1/rest_binding/caseservicev1p1_restbindv1p0.html. |
As well as sections marked as non-normative, all authoring guidelines, diagrams, examples, and notes in this specification are non-normative. Everything else in this specification is normative.
The key words MAY, MUST, MUST NOT, OPTIONAL, RECOMMENDED, REQUIRED, SHALL, SHALL NOT, SHOULD, and SHOULD NOT in this document $are to be interpreted as described in $[object Object].
An implementation of this specification that fails to implement a MUST/REQUIRED/SHALL requirement or fails to abide by a MUST NOT/SHALL NOT prohibition is considered nonconformant. SHOULD/SHOULD NOT/RECOMMENDED statements constitute a best practice. Ignoring a best practice does not violate conformance but a decision to disregard such guidance should be carefully considered. MAY/OPTIONAL statements indicate that implementers are entirely free to choose whether or not to implement the option.
The <a href="#document-set">Conformance and Certification Guide</a> for this specification may introduce greater normative constraints than those defined here for specific service or implementation categories.
- [RFC2119]
- Key words for use in RFCs to Indicate Requirement Levels. S. Bradner. IETF. March 1997. Best Current Practice. URL: https://www.rfc-editor.org/rfc/rfc2119
The following individuals contributed to the development of this document:
Name | Organization | Role |
---|---|---|
Susan Haught | 1EdTech Consortium, Inc. | Editor |
Colin Smythe | 1EdTech Consortium, Inc. | |
Bracken Mosbacker | 1EdTech Consortium, Inc. | |
Pepper Williams | Common Good Learning Tools, Inc. | |
Ed Jung | Learning Mate | |
Joshua Marks | Public Consulting Group | |
Raymond Baranoski | SAFARI Montage | |
Jared Booth | HMH | |
Barry Brahier | Infinite Campus | |
Deb Everhart | Credential Engine | |
Jeff Grann | Capella University | |
Bob Grogan | eLumen | |
Joel Hernandez | eLumen | |
David Ward | PCG | |
Stuart Sutton | Credential Engine | |
Andrew Brown | eLumen | |
Ben Herndon | PowerSchool | |
Brian Wales | SAFARI Montage | |
Christian Clark | Southern New Hampshire University | |
C. London | Southern New Hampshire University | |
Carrie Vail | PowerSchool | |
C. Brown | Unicon, Inc. | |
Darcy Wither | D2L | |
David Mayes | Gwinnett County Public Schools | |
Diego del Blanco | Unicon, Inc. | |
Davonne Eldridge | North Dakota Information Technology Deparment | |
Emma Lee | University of Montana | |
Heather Carle | Territorium | |
Joshua Heyman | Southern New Hampshire Universtiy | |
Joe Green | Territoruim | |
Christophe Konstantinos | TAO Testing | |
Keith Osburn | Georgia Department of Education | |
Lori Griffin | SAFARI Montage | |
Luke Zenger | Infinite Campus | |
Mark Ohringer | Randa Solutions | |
Marty Reed | Randa Solutions | |
Matthew Richards | Infinite Campus | |
Monica Dalvi | Amplify | |
Michael Moore | D2L | |
Paul Katula | Maryland Department of Education | |
Radian Baskoro | PowerSchool | |
Raymond Baranoski | SAFARI Montage | |
Scott Murray | PowerSchool | |
S. Rafalaski | SAFARI Montage | |
Steve Buettner | Edina Public Schools | |
Timothy Beekman | SAFARI Montage | |
Korsmo, Tracy A. | North Dakota Department of Public Instruction | |
Viktor Haag | D2L | |
Wendy Stephens | South Carolina Department of Education | |
Michelle Wagner | Broward County Public Schools | |
Xavi Aracil | 1EdTech | |
Tom Hoffmann | 1EdTech | |
Monica Watts | 1EdTech | |
Mark Leuba | 1EdTech | |
Beatriz Arnillas | 1EdTech | |
Joshua McGhee | 1EdTech |