Cornell University

Cornell University Config API

The config API from Cornell University — 5 operation(s) for config.

GitHub OpenAPI

Operations 5

GET /config/rosters.json Get available Cornell rosters #
GET /config/acadCareers.json Get available academic careers for a roster #
GET /config/acadGroups.json Get available academic groups for a roster #
GET /config/classLevels.json Get available class levels for a roster #
GET /config/subjects.json Get available subjects for roster #

Documentation

📖
Documentation
https://classes.cornell.edu/content/FA26/api-details

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/cornell/refs/heads/main/openapi/cornell-config-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/cornell/refs/heads/main/json-schema/cornell-class-schema.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/cornell/refs/heads/main/json-structure/cornell-class-structure.json

Other Resources

🔗
Examples
https://raw.githubusercontent.com/api-evangelist/cornell/refs/heads/main/examples/cornell-search-classes-example.json
🔗
Errors
https://raw.githubusercontent.com/api-evangelist/cornell/refs/heads/main/errors/cornell-errors.yml
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/cornell/refs/heads/main/examples/cornell-class-roster-rosters-example.json
🔗
Vocabulary
https://raw.githubusercontent.com/api-evangelist/cornell/refs/heads/main/vocabulary/cornell-vocabulary.yml
🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/cornell/refs/heads/main/json-ld/cornell-context.jsonld

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/cornell-config-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

cornell-config-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: A public API for retrieving classes at Cornell University
  version: '0.1'
  title: Cornell Classes Config API
  contact:
    name: Cornell Open Data Initiative
    url: https://codi.engineering.cornell.edu
    email: codi@cornellappdev.com
servers:
- url: https://classes.cornell.edu/api/2.0
tags:
- name: Config
paths:
  /config/rosters.json:
    get:
      tags:
      - Config
      summary: Get available Cornell rosters
      description: Return information about all available Cornell rosters
      responses:
        '200':
          description: A JSON of rosters
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/RostersResponse'
      operationId: getConfigRostersJson
      x-operation-id-source: derived
  /config/acadCareers.json:
    get:
      tags:
      - Config
      summary: Get available academic careers for a roster
      description: Return all available academic careers for a roster. Academic careers refer to student type (i.e. Undergraduate) or study type (i.e. Graduate Management).
      parameters:
      - name: roster
        in: query
        description: Roster semester & year (i.e. FA14, SP15)
        required: true
        schema:
          type: string
      responses:
        '200':
          description: A JSON of academic careers
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/AcadCareersResponse'
      operationId: getConfigAcadCareersJson
      x-operation-id-source: derived
  /config/acadGroups.json:
    get:
      tags:
      - Config
      summary: Get available academic groups for a roster
      description: Return all available academic groups for a roster. Academic groups refer to college type (i.e. Engineering) or study type (i.e. Graduate Management).
      parameters:
      - name: roster
        in: query
        description: Roster semester & year (i.e. FA14, SP15)
        required: true
        schema:
          type: string
      responses:
        '200':
          description: A JSON of academic groups
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/AcadGroupsResponse'
      operationId: getConfigAcadGroupsJson
      x-operation-id-source: derived
  /config/classLevels.json:
    get:
      tags:
      - Config
      summary: Get available class levels for a roster
      description: Return all available class levels for a roster. Class levels refer to the level of the course as specified by the course number (i.e. 1000, 2000). For instance, CS 4300 has a class level of 4000.
      parameters:
      - name: roster
        in: query
        description: Roster semester & year (i.e. FA14, SP15)
        required: true
        schema:
          type: string
      responses:
        '200':
          description: A JSON of class levels
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ClassLevelsResponse'
      operationId: getConfigClassLevelsJson
      x-operation-id-source: derived
  /config/subjects.json:
    get:
      tags:
      - Config
      summary: Get available subjects for roster
      description: Return all available course subjects for a roster.
      parameters:
      - name: roster
        in: query
        description: Roster semester & year (i.e. FA14, SP15)
        required: true
        schema:
          type: string
      responses:
        '200':
          description: A JSON of subjects
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/SubjectsResponse'
      operationId: getConfigSubjectsJson
      x-operation-id-source: derived
components:
  schemas:
    ClassLevelsResponse:
      type: object
      properties:
        status:
          type: string
          example: success
        data:
          $ref: '#/components/schemas/ClassLevelsResponse_data'
        message:
          type: string
          example: null
        meta:
          $ref: '#/components/schemas/Meta'
      example:
        data:
          classLevels:
          - descr: 1000
            value: 1000
          - descr: 1000
            value: 1000
        meta:
          referenceDttm: 2015-01-14T18:16:01-0500
          copyright: Cornell University, Office of the University Registrar
        message: null
        status: success
    SubjectsResponse_data:
      properties:
        subjects:
          type: array
          items:
            $ref: '#/components/schemas/Subjects'
      example:
        subjects:
        - descr: Asian American Studies
          descrformal: Asian American Studies
          value: AAS
        - descr: Asian American Studies
          descrformal: Asian American Studies
          value: AAS
    SubjectsResponse:
      type: object
      properties:
        status:
          type: string
          example: success
        data:
          $ref: '#/components/schemas/SubjectsResponse_data'
        message:
          type: string
          example: null
        meta:
          $ref: '#/components/schemas/Meta'
      example:
        data:
          subjects:
          - descr: Asian American Studies
            descrformal: Asian American Studies
            value: AAS
          - descr: Asian American Studies
            descrformal: Asian American Studies
            value: AAS
        meta:
          referenceDttm: 2015-01-14T18:16:01-0500
          copyright: Cornell University, Office of the University Registrar
        message: null
        status: success
    ClassLevels:
      type: object
      properties:
        value:
          type: string
          example: 1000
        descr:
          type: integer
          example: 1000
      example:
        descr: 1000
        value: 1000
    RostersResponse:
      type: object
      properties:
        status:
          type: string
          example: success
        data:
          $ref: '#/components/schemas/RostersResponse_data'
        message:
          type: string
          example: null
        meta:
          $ref: '#/components/schemas/RostersResponse_meta'
      example:
        data:
          rosters:
          - lastModifiedDttm: 2018-04-02T19:35:43-0400
            strm: 2573
            defaultInstructionMode: P
            sharing: N
            isDefaultRoster: N
            version:
              referenceDttm: 2015-01-14T18:16:01-0500
              catalogDttm: 2015-01-14T18:21:04-0500
              showCatalogNote: Y
              catalogCourseNote: null
              catalog:
                acalogCatalogId: 22
                descr: Courses of Study 2014-2015
                descrshort: CoS 14-15
                version:
                  status: COMPLETE
              descriptionSource: CATALOG
              status: COMPLETE
            archiveMode: Y
            defaultCampus: MAIN
            descr: Fall 2014
            defaultSessionCode: 1
            descrshort: 2014FA
            slug: FA14
            defaultLocation: ITH
          - lastModifiedDttm: 2018-04-02T19:35:43-0400
            strm: 2573
            defaultInstructionMode: P
            sharing: N
            isDefaultRoster: N
            version:
              referenceDttm: 2015-01-14T18:16:01-0500
              catalogDttm: 2015-01-14T18:21:04-0500
              showCatalogNote: Y
              catalogCourseNote: null
              catalog:
                acalogCatalogId: 22
                descr: Courses of Study 2014-2015
                descrshort: CoS 14-15
                version:
                  status: COMPLETE
              descriptionSource: CATALOG
              status: COMPLETE
            archiveMode: Y
            defaultCampus: MAIN
            descr: Fall 2014
            defaultSessionCode: 1
            descrshort: 2014FA
            slug: FA14
            defaultLocation: ITH
        meta:
          copyright: Cornell University, Office of the University Registrar
        message: null
        status: success
    Meta:
      type: object
      properties:
        copyright:
          type: string
          example: Cornell University, Office of the University Registrar
        referenceDttm:
          type: string
          example: 2015-01-14T18:16:01-0500
      example:
        referenceDttm: 2015-01-14T18:16:01-0500
        copyright: Cornell University, Office of the University Registrar
    AcadCareersResponse_data:
      properties:
        acadCareers:
          type: array
          items:
            $ref: '#/components/schemas/AcadCareers'
      example:
        acadCareers:
        - descr: Undergraduate
          value: UG
        - descr: Undergraduate
          value: UG
    AcadCareersResponse:
      type: object
      properties:
        status:
          type: string
          example: success
        data:
          $ref: '#/components/schemas/AcadCareersResponse_data'
        message:
          type: string
          example: null
        meta:
          $ref: '#/components/schemas/Meta'
      example:
        data:
          acadCareers:
          - descr: Undergraduate
            value: UG
          - descr: Undergraduate
            value: UG
        meta:
          referenceDttm: 2015-01-14T18:16:01-0500
          copyright: Cornell University, Office of the University Registrar
        message: null
        status: success
    AcadGroups:
      type: object
      properties:
        value:
          type: string
          example: AG
        descr:
          type: string
          example: Agriculture and Life Sciences
      example:
        descr: Agriculture and Life Sciences
        value: AG
    Subjects:
      type: object
      properties:
        value:
          type: string
          example: AAS
        descr:
          type: string
          example: Asian American Studies
        descrformal:
          type: string
          example: Asian American Studies
      example:
        descr: Asian American Studies
        descrformal: Asian American Studies
        value: AAS
    Roster_version_catalog:
      properties:
        descrshort:
          type: string
          example: CoS 14-15
        descr:
          type: string
          example: Courses of Study 2014-2015
        acalogCatalogId:
          type: integer
          example: 22
        version:
          $ref: '#/components/schemas/Roster_version_catalog_version'
      example:
        acalogCatalogId: 22
        descr: Courses of Study 2014-2015
        descrshort: CoS 14-15
        version:
          status: COMPLETE
    Roster:
      type: object
      properties:
        slug:
          type: string
          example: FA14
        isDefaultRoster:
          type: string
          example: N
        strm:
          type: string
          example: 2573
        descr:
          type: string
          example: Fall 2014
        descrshort:
          type: string
          example: 2014FA
        defaultSessionCode:
          type: string
          example: 1
        defaultCampus:
          type: string
          example: MAIN
        defaultLocation:
          type: string
          example: ITH
        defaultInstructionMode:
          type: string
          example: P
        sharing:
          type: string
          example: N
        archiveMode:
          type: string
          example: Y
        version:
          $ref: '#/components/schemas/Roster_version'
        lastModifiedDttm:
          type: string
          example: 2018-04-02T19:35:43-0400
      example:
        lastModifiedDttm: 2018-04-02T19:35:43-0400
        strm: 2573
        defaultInstructionMode: P
        sharing: N
        isDefaultRoster: N
        version:
          referenceDttm: 2015-01-14T18:16:01-0500
          catalogDttm: 2015-01-14T18:21:04-0500
          showCatalogNote: Y
          catalogCourseNote: null
          catalog:
            acalogCatalogId: 22
            descr: Courses of Study 2014-2015
            descrshort: CoS 14-15
            version:
              status: COMPLETE
          descriptionSource: CATALOG
          status: COMPLETE
        archiveMode: Y
        defaultCampus: MAIN
        descr: Fall 2014
        defaultSessionCode: 1
        descrshort: 2014FA
        slug: FA14
        defaultLocation: ITH
    RostersResponse_meta:
      properties:
        copyright:
          type: string
          example: Cornell University, Office of the University Registrar
      example:
        copyright: Cornell University, Office of the University Registrar
    Roster_version:
      properties:
        status:
          type: string
          example: COMPLETE
        referenceDttm:
          type: string
          example: 2015-01-14T18:16:01-0500
        catalogDttm:
          type: string
          example: 2015-01-14T18:21:04-0500
        descriptionSource:
          type: string
          example: CATALOG
        showCatalogNote:
          type: string
          example: Y
        catalogCourseNote:
          type: string
          example: null
        catalog:
          $ref: '#/components/schemas/Roster_version_catalog'
      example:
        referenceDttm: 2015-01-14T18:16:01-0500
        catalogDttm: 2015-01-14T18:21:04-0500
        showCatalogNote: Y
        catalogCourseNote: null
        catalog:
          acalogCatalogId: 22
          descr: Courses of Study 2014-2015
          descrshort: CoS 14-15
          version:
            status: COMPLETE
        descriptionSource: CATALOG
        status: COMPLETE
    ClassLevelsResponse_data:
      properties:
        classLevels:
          type: array
          items:
            $ref: '#/components/schemas/ClassLevels'
      example:
        classLevels:
        - descr: 1000
          value: 1000
        - descr: 1000
          value: 1000
    Roster_version_catalog_version:
      properties:
        status:
          type: string
          example: COMPLETE
      example:
        status: COMPLETE
    AcadGroupsResponse:
      type: object
      properties:
        status:
          type: string
          example: success
        data:
          $ref: '#/components/schemas/AcadGroupsResponse_data'
        message:
          type: string
          example: null
        meta:
          $ref: '#/components/schemas/Meta'
      example:
        data:
          acadGroups:
          - descr: Agriculture and Life Sciences
            value: AG
          - descr: Agriculture and Life Sciences
            value: AG
        meta:
          referenceDttm: 2015-01-14T18:16:01-0500
          copyright: Cornell University, Office of the University Registrar
        message: null
        status: success
    RostersResponse_data:
      properties:
        rosters:
          type: array
          items:
            $ref: '#/components/schemas/Roster'
      example:
        rosters:
        - lastModifiedDttm: 2018-04-02T19:35:43-0400
          strm: 2573
          defaultInstructionMode: P
          sharing: N
          isDefaultRoster: N
          version:
            referenceDttm: 2015-01-14T18:16:01-0500
            catalogDttm: 2015-01-14T18:21:04-0500
            showCatalogNote: Y
            catalogCourseNote: null
            catalog:
              acalogCatalogId: 22
              descr: Courses of Study 2014-2015
              descrshort: CoS 14-15
              version:
                status: COMPLETE
            descriptionSource: CATALOG
            status: COMPLETE
          archiveMode: Y
          defaultCampus: MAIN
          descr: Fall 2014
          defaultSessionCode: 1
          descrshort: 2014FA
          slug: FA14
          defaultLocation: ITH
        - lastModifiedDttm: 2018-04-02T19:35:43-0400
          strm: 2573
          defaultInstructionMode: P
          sharing: N
          isDefaultRoster: N
          version:
            referenceDttm: 2015-01-14T18:16:01-0500
            catalogDttm: 2015-01-14T18:21:04-0500
            showCatalogNote: Y
            catalogCourseNote: null
            catalog:
              acalogCatalogId: 22
              descr: Courses of Study 2014-2015
              descrshort: CoS 14-15
              version:
                status: COMPLETE
            descriptionSource: CATALOG
            status: COMPLETE
          archiveMode: Y
          defaultCampus: MAIN
          descr: Fall 2014
          defaultSessionCode: 1
          descrshort: 2014FA
          slug: FA14
          defaultLocation: ITH
    AcadGroupsResponse_data:
      properties:
        acadGroups:
          type: array
          items:
            $ref: '#/components/schemas/AcadGroups'
      example:
        acadGroups:
        - descr: Agriculture and Life Sciences
          value: AG
        - descr: Agriculture and Life Sciences
          value: AG
    AcadCareers:
      type: object
      properties:
        value:
          type: string
          example: UG
        descr:
          type: string
          example: Undergraduate
      example:
        descr: Undergraduate
        value: UG