{
  "$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."
    }
  }
}