# Open Education API course offering associations API

**Canonical:** https://apis.io/apis/open-education-api/open-education-api-course-offering-associations-api/  
**Provider:** Open Education API — https://apis.io/providers/open-education-api/  
**Base URL:** https://demo01.eduapi.nl/v6  
**Documentation:** https://oeapi.eu/specification/v6.0/

Open Education API course offering associations API is one of 29 APIs that [Open Education API](https://apis.io/providers/open-education-api/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 10 JSON Schema definitions. Tagged areas include course offering associations. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 10 JSON Schemas.

The course offering associations API provides information about the association between a course offering and a person (e.g. students, lecturers, etc). Associations can be posted between institutions. This requires detailed information on the course offering and the persons. To allow for this information a complete person object and offering object can be part of the API. The structure is explained in the following model: <table> <tr> <td></td> <td colspan=3 align=center>offering</td> </tr> <tr> <td rowspan=3>student</td> <td></td> <!-- <td>internal</td> --> <td>external</td> </tr> <tr> <td>internal</td> <td>POST <a href="#tag/course-offering-associations/operation/createExternalCourseOfferingAssociationByopenId"> /course-offering-associations/external/me</a>Retrieves student details from the well known endpoint that exposes person information at the home institution. It passes offering details (provided by external institution) to the home institution so the home institution can create a placeholder for the offering and its results. </td> </tr> <tr> <td>external</td> <td>no support needed</td> </tr> </table> Direct update of current information: <a href="#tag/course-offering-associations/operation/partialUpdateCourseOfferingAssociationById"> PATCH /course-offering-associations/{courseOfferingAssociationId}</a> This call is currently limited to passing results and a remote state. For future use other association resource information could be passed. More information on the support for student mobility can be found <a href="https://swimlanes.io/d/s5mfpj7Si">here</a>

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| POST | `/course-offering-associations/external/me` | POST /course-offering-associations/external/me |
| GET | `/course-offering-associations/{courseOfferingAssociationId}` | GET /course-offering-associations/{courseOfferingAssociationId} |
| PUT | `/course-offering-associations/{courseOfferingAssociationId}` | PUT /course-offering-associations/{courseOfferingAssociationId} |
| PATCH | `/course-offering-associations/{courseOfferingAssociationId}` | PATCH /course-offering-associations/{courseOfferingAssociationId} |
| GET | `/course-offerings/{courseOfferingId}/course-offering-associations` | GET /course-offerings/{courseOfferingId}/course-offering-associations |
| GET | `/persons/{personId}/course-offering-associations` | GET /persons/{personId}/course-offering-associations |

## Machine-readable artifacts (12)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/open-education-api/refs/heads/main/openapi/open-education-api-course-offering-associations-api-openapi.yml
- **Documentation** — https://oeapi.eu/v6.0/
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/open-education-api/refs/heads/main/json-schema/open-education-api-test-component-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/open-education-api/refs/heads/main/json-schema/open-education-api-learning-component-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/open-education-api/refs/heads/main/json-schema/open-education-api-person-properties-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/open-education-api/refs/heads/main/json-schema/open-education-api-learning-outcome-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/open-education-api/refs/heads/main/json-schema/open-education-api-organisation-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/open-education-api/refs/heads/main/json-schema/open-education-api-academic-session-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/open-education-api/refs/heads/main/json-schema/open-education-api-component-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/open-education-api/refs/heads/main/json-schema/open-education-api-organization-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/open-education-api/refs/heads/main/json-schema/open-education-api-room-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/open-education-api/refs/heads/main/json-schema/open-education-api-group-schema.json

## Other Open Education API APIs (12)

- [Open Education API academic sessions API](https://apis.io/apis/open-education-api/open-education-api-academic-sessions-api/)
- [Open Education API Associations API](https://apis.io/apis/open-education-api/open-education-api-associations-api/)
- [Open Education API Buildings API](https://apis.io/apis/open-education-api/open-education-api-buildings-api/)
- [Open Education API Components API](https://apis.io/apis/open-education-api/open-education-api-components-api/)
- [Open Education API course offerings API](https://apis.io/apis/open-education-api/open-education-api-course-offerings-api/)
- [Open Education API Courses API](https://apis.io/apis/open-education-api/open-education-api-courses-api/)
- [Open Education API Documents API](https://apis.io/apis/open-education-api/open-education-api-documents-api/)
- [Open Education API education specifications API](https://apis.io/apis/open-education-api/open-education-api-education-specifications-api/)
- [Open Education API Groups API](https://apis.io/apis/open-education-api/open-education-api-groups-api/)
- [Open Education API learning component offering associations API](https://apis.io/apis/open-education-api/open-education-api-learning-component-offering-associations-api/)
- [Open Education API learning component offerings API](https://apis.io/apis/open-education-api/open-education-api-learning-component-offerings-api/)
- [Open Education API learning components API](https://apis.io/apis/open-education-api/open-education-api-learning-components-api/)

## Tags

course offering associations

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/open-education-api/open-education-api-course-offering-associations-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/open-education-api/.
