University of Maryland College Park · Schema

Course

Represents a University of Maryland course as scraped from Testudo and exposed by the umd.io API.

EducationHigher EducationUniversityUnited StatesOpen DataCoursesStudent Run

Properties

Name	Type	Description
course_id	string	A unique string ID with a four-letter dept_id followed by a three digit course number and an optional letter.
semester	string	Numeric representation of the semester, in format YYYYMM.
name	string	String name of the course.
dept_id	string	Four letter department code.
department	string	Full name of the department that offers the course.
credits	string	The number of credits the course is worth.
description	string	String description of the course, as it appears on Testudo.
grading_method	array	Array of string grading options available: Regular, Pass-Fail, Audit, Sat-Fail.
gen_ed	array	General Education requirements the course fulfills. Array of arrays: outer layer is OR, inner layer is AND.
core	array	Array of strings of CORE requirements filled by a course.
relationships	object
sections	array	The sections of this course, either section ids or full Section objects.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://api.umd.io/v1/schemas/course.json",
  "title": "Course",
  "description": "Represents a University of Maryland course as scraped from Testudo and exposed by the umd.io API.",
  "type": "object",
  "properties": {
    "course_id": {
      "type": "string",
      "description": "A unique string ID with a four-letter dept_id followed by a three digit course number and an optional letter.",
      "examples": ["MATH140"]
    },
    "semester": {
      "type": "string",
      "description": "Numeric representation of the semester, in format YYYYMM.",
      "examples": ["202608"]
    },
    "name": {
      "type": "string",
      "description": "String name of the course.",
      "examples": ["Calculus I"]
    },
    "dept_id": {
      "type": "string",
      "description": "Four letter department code.",
      "examples": ["MATH"]
    },
    "department": {
      "type": "string",
      "description": "Full name of the department that offers the course.",
      "examples": ["Mathematics"]
    },
    "credits": {
      "type": "string",
      "description": "The number of credits the course is worth.",
      "examples": ["4"]
    },
    "description": {
      "type": "string",
      "description": "String description of the course, as it appears on Testudo."
    },
    "grading_method": {
      "type": "array",
      "items": { "type": "string" },
      "description": "Array of string grading options available: Regular, Pass-Fail, Audit, Sat-Fail."
    },
    "gen_ed": {
      "type": "array",
      "items": {
        "type": "array",
        "items": { "type": "string" }
      },
      "description": "General Education requirements the course fulfills. Array of arrays: outer layer is OR, inner layer is AND."
    },
    "core": {
      "type": "array",
      "items": { "type": "string" },
      "description": "Array of strings of CORE requirements filled by a course."
    },
    "relationships": {
      "type": "object",
      "properties": {
        "coreqs": { "type": ["string", "null"], "description": "Courses that must be taken with this one." },
        "prereqs": { "type": ["string", "null"], "description": "Requirements for taking this course." },
        "formerly": { "type": ["string", "null"], "description": "Previous course codes that were the same course." },
        "restrictions": { "type": ["string", "null"], "description": "Additional restrictions/requirements for taking the course." },
        "additional_info": { "type": ["string", "null"], "description": "Any additional information listed on Testudo." },
        "also_offered_as": { "type": ["string", "null"], "description": "Other course codes representing the same course (cross-listing)." },
        "credit_granted_for": { "type": ["string", "null"], "description": "Courses that are equivalent in credit." }
      }
    },
    "sections": {
      "type": "array",
      "items": { "type": ["string", "object"] },
      "description": "The sections of this course, either section ids or full Section objects."
    }
  }
}