# University of Groningen Ocasys Course Catalog API

**Canonical:** https://apis.io/apis/university-of-groningen/ocasys-course-catalog/  
**Provider:** University of Groningen — https://apis.io/providers/university-of-groningen/  
**Base URL:** https://ocasys.rug.nl/api  
**Documentation:** https://ocasys.rug.nl/

University of Groningen Ocasys Course Catalog API is one of 6 APIs that [University of Groningen](https://apis.io/providers/university-of-groningen/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Course Catalog, Education, Curriculum, Registrar, and Open Data. The published artifact set on APIs.io includes an OpenAPI specification and authentication docs.

The JSON backend behind Ocasys, the University's own course and degree-programme catalog. Verified live 2026-08-30 with no credentials: course search, full course records, the catalog page projection, programme search, faculties and organizational units, controlled option lists and the academic-year list all return 200 to an anonymous GET. Course records are bilingual and carry ECTS credits, study level, assessments, formats, prerequisites, offerings, ENLIGHT alliance status and per-course UN Sustainable Development Goal flags. Enrollment, permission and course-offering paths in the same namespace return 403 without an institutional SAML session and are documented as gated, not as callable. This is the one genuinely institution-engineered API surface in the University's footprint. The OpenAPI below is DERIVED by API Evangelist from live probes — the University publishes none, and does not advertise this interface at all.

## Operations (9)

| Method | Path | Summary |
|---|---|---|
| GET | `/year-status` | List every academic year the catalog holds |
| GET | `/year/next-academic-year-start-date` | Start date of the next academic year |
| GET | `/orgunit/faculties-and-universities` | List faculties and the university root organizational unit |
| GET | `/{academicYear}/course` | Search courses within one academic year |
| GET | `/{academicYear}/course/{courseCode}` | Get one course by its catalog code |
| GET | `/{academicYear}/course/page/{courseCode}` | Get the catalog page projection of one course |
| GET | `/{academicYear}/program` | Search degree programmes within one academic year |
| GET | `/{academicYear}/option-list` | List the controlled option lists used by course and programme records |
| GET | `/{academicYear}/course-offering` | List course offerings (institutional session required) |

## Machine-readable artifacts (16)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/university-of-groningen/refs/heads/main/openapi/university-of-groningen-course-catalog-api-openapi.yml
- **x-openapi-original** — https://raw.githubusercontent.com/api-evangelist/university-of-groningen/refs/heads/main/openapi/_original/university-of-groningen-course-catalog-api.yaml
- **Website** — https://ocasys.rug.nl/
- **x-json-schema** — https://raw.githubusercontent.com/api-evangelist/university-of-groningen/refs/heads/main/json-schema/university-of-groningen-ocasys-course-schema.json
- **x-json-schema** — https://raw.githubusercontent.com/api-evangelist/university-of-groningen/refs/heads/main/json-schema/university-of-groningen-ocasys-program-schema.json
- **x-json-ld** — https://raw.githubusercontent.com/api-evangelist/university-of-groningen/refs/heads/main/json-ld/university-of-groningen-course-context.jsonld
- **x-rules** — https://raw.githubusercontent.com/api-evangelist/university-of-groningen/refs/heads/main/rules/university-of-groningen-course-catalog-rules.yml
- **Vocabulary** — https://raw.githubusercontent.com/api-evangelist/university-of-groningen/refs/heads/main/vocabulary/university-of-groningen-course-catalog-vocabulary.yml
- **Errors** — https://raw.githubusercontent.com/api-evangelist/university-of-groningen/refs/heads/main/errors/university-of-groningen-errors.yml
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/university-of-groningen/refs/heads/main/authentication/university-of-groningen-authentication.yml
- **x-example** — https://raw.githubusercontent.com/api-evangelist/university-of-groningen/refs/heads/main/examples/university-of-groningen-ocasys-course-search-example.json
- **x-example** — https://raw.githubusercontent.com/api-evangelist/university-of-groningen/refs/heads/main/examples/university-of-groningen-ocasys-get-course-example.json
- **x-example** — https://raw.githubusercontent.com/api-evangelist/university-of-groningen/refs/heads/main/examples/university-of-groningen-ocasys-program-search-example.json
- **x-example** — https://raw.githubusercontent.com/api-evangelist/university-of-groningen/refs/heads/main/examples/university-of-groningen-ocasys-faculties-example.json
- **x-example** — https://raw.githubusercontent.com/api-evangelist/university-of-groningen/refs/heads/main/examples/university-of-groningen-ocasys-problem-detail-example.json
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/university-of-groningen/refs/heads/main/apis.yml

## Other University of Groningen APIs (5)

- [University of Groningen Research Database OAI-PMH](https://apis.io/apis/university-of-groningen/pure-oai-pmh/)
- [University of Groningen Identity Provider (SURFconext / eduGAIN)](https://apis.io/apis/university-of-groningen/identity-provider/)
- [University of Groningen Research Portal (Pure) REST API](https://apis.io/apis/university-of-groningen/pure-ws-api/)
- [University of Groningen research data collection on DataverseNL](https://apis.io/apis/university-of-groningen/dataversenl-collection/)
- [University of Groningen Library discovery (OCLC WorldCat)](https://apis.io/apis/university-of-groningen/worldcat-discovery/)

## Tags

Course Catalog, Education, Curriculum, Registrar, Open Data

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/university-of-groningen/ocasys-course-catalog/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/university-of-groningen/.
