> For the complete documentation index, see [llms.txt](https://developerdocs.instructure.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developerdocs.instructure.com/services/ab-connect/reference/associations.md).

# 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](https://rosetta.commongoodlt.com/) 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](mailto:absupport@instructure.com?subject=AB%20Connect%20Question%20or%20Comment%20%28v4.1%20API%29) 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

```json
{
    "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](/services/ab-connect/introduction/licensing.md) for more details on licensing in AB Connect.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developerdocs.instructure.com/services/ab-connect/reference/associations.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
