CoursesWebServicev2

This API returns the public information for course offerings (course sections) for a given termCode and subjectCode.   The response is available as JSON or XML.  Authentication is required via an API Key which is received after registering an application within the Developer Portal.  

Request Parameters

Name

Type

Restriction

Description

apikey

string required Enter the API Key received within the Developer Portal upon registration of an application for this API.

subjectCode

string required
Specify the course subject code.  This data may include ampersands which should be encoded as %26.  Example:  ACCT, AFAMPLSCENGL, EP&E

termCode

string optional
Specify the term code.  This is a 6 character string where the first four characters are the year and the last 2 characters are the term designation (01 = Spring, 02 = Summer, 03 = Fall).
Example:
  • Spring 2014 would be 201401
 If no termCode is submitted, the API will use the current default term (Spring or Fall).  This value changes to the next term on January 3rd and June 1st.

mode

string optional
Specify the desired response output type.  Example:  json or xml
school string optional Service returns default YC Yale College and SU Summer Sessions.  To specify Graduate School, submit school=GS.

Data Response

Name

Type

Description

cSectionStatus

string
Course section status.  (A - Active, B - Moved to spring term, C - Cancelled, D - Moved to preceding fall term, E - Closed to further enrollments, N - Number changed)

class

string Class.  Example:  edu.yale.course.Course

courseNumber

alphanumeric
Course number.  Example:  101

courseTitle

string Full title for the course.  Example:  Geometry of Nature

crn

numeric Unique Course Registration Number (CRN).  Example:  20233

department

string
Four-character code for department offering the section.  This value may resemble the subject code, but the two are not the same.  Example:  The department of Spanish and Portuguese (SP&P) offers courses with subject codes SPAN and PORT, the English department (ENGL) offers courses with subject code ENGL.

description

string Full description for the course (HTML-safe).

distDesg*​

string The designations for Yale College distributional requirements.

designation

description

ACAS
ACCS
ACMF
ACSI
DRAC
DRDD
DRDE
DRDI
DRPW
DRSD
DRSM
DRSX
DRTD
DRTM
FSY
LCLE
PREI
STAR
SUAB
SUCR
VAR1
VAR2
VAR3
VAR4
VAR5
VCPE
VDIV
VETH
VNT
VNXN
VOT
VPCH
VPMM
VSMN
VTHE
YANA
YANB
YANL
YANS
YCHU
YCL1
YCL2
YCL3
YCL4
YCL5
YCQR
YCSC
YCSO
YCWR
YEC1
YEC2
YEC3
YEC4
YEC5
YEC6
YEC7
YEC8
YECC
YECD
YECE
YECF
YECH
YECI
YECL
YECM
YECN
YECP
YECW
YEN8
YEN9
YENA
YENJ
YENS
YENW
YEP1
YEPA
YEPE
YEPP
YEPR
YEPS
YEPT
YGLD
YGLR
YGLS
YMAA
YMAC
YMAG
YMAL
YMAN
YMAR
YMAS
YMAT
YPYA
YPYC
YPYN
YPYR
YPYS
YXQR
YXWR
AC:Advanced Studio
AC:Core Studio
 
AC:Systems Integration
DR:Acting
DR:Dramaturgy&Dramatic
DR:Design
DR:Directing
DR:Playwriting
DR:Sound Design
DR:Stage Management
DR:Drama 6
DR:Tech Design
DR:Theater Management
SU:Freshman Scholars
LW:Clinical Evaluation 
YC History: Preindustrial
SU:STARS Program
SU:Course Outside U.S>
SU:College students only
DI:Area I
DI:Area II
DI:Area III
DI:Area IV
DI:Area V 
DI:Clin Pastoral Education
DI:Diversity
DI:Ethics
DI:New Testament
DI:Non-Christian Religions
DI:Old Testament
DI:Preaching
DI:Preventing Min Misconduct
DI:Supervised Ministries
DI:Theology
YC Anthropology: Archaeology
YC Anthropology: Biological
YC Anthropology: Linguistic
YC Anthropology: Sociocultural
Humanities Area
Language 1 Skill
Language 2 Skill
Language 3 Skill
Language 4 Skill
Language 5 Skill
Quantitative Reasoning Skill
Sciences Area
Social Sciences Area 
Writing Skill
YC ECON: Environment
YC ECON: History
YC ECON: Industrial Orgnztion
YC ECON: International
YC ECON: Methodology
YC ECON: Microtheory
YC ECON: Poverty
YC ECON: Public
YC ECON: Core
YC ECON: Development
YC ECON: Education
YC ECON: Finance
YC ECON: Health
YC ECON: Introductory
YC ECON: Labor
YC ECON: Macroeconomics
YC ECON: Neuro
YC ECON: Political Economy
YC ECON: Law
YC English: Pre-1800 Lit
YC English: Pre-1900 Lit
YC English: American Lit
YC English: Junior Seminar
YC English: Senior Seminar
YC English: Creative Writing
YC EP&E: Intro Statistics
YC EP&E: Advanced Seminar
YC EP&E: Intro Ethics
YC EP&E: Intro Political Phil
YC EP&E: Rationality Core
YC EP&E: PoliticalSystems Core
YC EP&E: Social Theory Core
YC Global Affairs: Development
YC Global Affairs: Research
YC Global Affairs: Security
YC Math: Core Algebra
YC Math: Core Complex Analysis
YC Math: Geometry/Topology
YC Math: Logic/Foundations
YC Math: Analysis
YC Math: Core Real Analysis
YC Math: Stat/Applied Math
YC Math: Algebra/Number Theory
YC Psychology: AdvSci NeuroTrk
YC Psychology: Core
YC Psychology: Natural Science
YC Psychology: ResearchMethods
YC Psychology: Social Science
Quant. Reasoning Skill (Opt.)
Writing Skill (Opt.)

finalExam

numeric This code indicates the exam group to which this section belongs.  This is only valid for Yale College.  If no code, then no final exam is given.   Refer to the site of the Office of the Registrar for detailed times and locations.

instructorList*

string

List of instructor names.  TAs are not included due to FERPA rules.

instructorUPI*

string List of instructor Yale UPI.  May or may not appear in same order as names list above.
meetingEndTimeList string List of meeting end times in same order as meetingStartTimeList below (class meeting 1, 2, 3, etc.)
meetingPattern* string String that describes the days of the week and times that the section meets.
meetingStartTimeList string List of meeting start times in same order as meetingEndTimeList above  (class meeting 1, 2, 3, etc.)
prerequisites string Description of prerequisites for course: other courses or skill levels.
primXLst string The course number (example PLSC118ASTR170) of the primary course in a multi-title relationship.  This would return a value only if the offering in this record were a “secondary” numbering.

schoolCode

string Two-character abbreviation for the school.  Example:  YC

schoolDescription

string Full name of school offering the course.  Example:  Yale College

scndXLst*

string The course number(s) of the secondary course(s) in a multi-title relationship excluding the current number.

sectionNumber

numeric Section for the course.  Example:  01
sectionStatus string A=Active;O=Active;C=Cancelled;X=Not Offered  (same as cSectionStatus)
session string For Summer courses, the 3-character session identifier (e.g. H5A)

shortTitle

string Short title for the course.  Example:  Geometry of Nature

subjectCode

string Short code for subject used in course number.  Example:  MATH

subjectNumber

string Concatenated subject code and number.  Example:  MATH101
syllabusLink string URL for location of the section syllabus

termCode

numeric Four digit year and two digit term (01, 02, 03) without spaces.  Example:  201401=Spring 2014 

*Response may contain multiple values