Associations (CASE)

The associations relationship on Standards provides CASE (Competency and Academic Standards Exchange) identifiers matched to Academic Benchmarks standards. CASE is a machine-readable format for exchanging competency frameworks and academic standards. Satchel Rosetta Exchange is a publicly available portal that aggregates learning standards from all 50 US states and dozens of other countries in CASE format, where each standard is identified by a globally unique CFItem GUID.

AB Connect automatically matches Satchel Rosetta Exchange CFItem identifiers to AB standards using similarity matching. Associations represent the best Satchel Rosetta Exchange counterpart for each AB standard — matches are not exhaustive but are selected by confidence. Multiple AB standards can share the same CASE GUID when they correspond to the same Satchel Rosetta Exchange item. Matches are refreshed weekly as part of the regular standards publish cycle.

Access to the associations relationship requires a Professional license. If your credentials are correct and you are still receiving a 401 error (or no results), check with AB Support to ensure your license includes associations.

CASE® is a registered trademark of 1EdTech Consortium, Inc. Satchel Rosetta Exchange was formerly known as CASE Network 2.

Requesting Associations

Like other relationships, associations must be explicitly requested using the fields parameter:

`https://api.abconnect.instructure.com/rest/v4.1/standards/{guid}?fields[standards]=associations`

This returns the associations relationship data in the relationships section of the response. Each association contains the type and id (the CASE CFItem GUID) of the matched standard.

To include the full resource details of the associated standards, add the include parameter:

`https://api.abconnect.instructure.com/rest/v4.1/standards/{guid}?fields[standards]=associations&include=associations`

Example Request

GET /rest/v4.1/standards/A2345678-1234-5678-9ABC-DEF012345678?fields[standards]=statement,number,associations&include=associations

Example Response

{
    "data": {
        "id": "A2345678-1234-5678-9ABC-DEF012345678",
        "type": "standards",
        "attributes": {
            "statement": {
                "descr": "Solve real-world and mathematical problems involving area..."
            },
            "number": {
                "enhanced": "CCSS.Math.Content.6.G.A.1"
            }
        },
        "relationships": {
            "associations": {
                "data": [
                    {
                        "type": "standards",
                        "id": "B9876543-ABCD-EF01-2345-6789ABCDEF01"
                    }
                ],
                "links": {
                    "related": "https://api.abconnect.instructure.com/rest/v4.1/standards/A2345678-1234-5678-9ABC-DEF012345678/associations"
                }
            }
        }
    },
    "included": [
        {
            "id": "B9876543-ABCD-EF01-2345-6789ABCDEF01",
            "type": "standards"
        }
    ]
}

Filtering by Associations

You can filter standards to find only those that have CASE matches:

`filter[standards]=(not isempty(associations))`

This can be combined with other standard filters. For example, to find California standards with CASE associations:

`filter[standards]=(document.publication.authorities.descr eq 'California DOE' and not isempty(associations))`

Note that filtering by a specific CASE GUID (reverse lookup) is not currently supported. To find the AB standard for a known CASE identifier, retrieve standards with associations and match on the client side.

Licensing

The associations relationship requires a Professional license. See Licensing Considerations for more details on licensing in AB Connect.