GET schedule/courses

Returns courses that match the criteria given by the query parameters.

Search criteria is documented below. The keyword parameters search the course title or course description for matches and returns courses where matches are found.

While no search terms are necessarily required, it is highly recommended that queries provide as many query parameters as possible to shorten the time of the search and to narrow down the number of results returned. At a minimum, all search queries should specify a year, a term and at least 1 other query parameter listed below.

Resource URI Example(s)

/schedule/courses?year=2012&term=spring&qs=geometry

/schedule/courses?year=2012&term=summer&subject=CHEM&qw_o=molecular+atomic

Query Parameter(s)

The parameters described below can be used in any combination on a search query.
Parameter Value(s)
year optional, but highly recommended <4-DIGIT YEAR>

Search for courses offered in the given 4-digit year.
term optional, but highly recommended spring

Search for courses offered in the spring semester.

summer

Search for courses offered in the summer semester.

fall

Search for courses offered in the fall semester.
sectionTypeCode optional, can be specified multiple times (e.g. sectionTypeCode=ONL§ionTypeCode=LEC) ONL

Search for courses that have online sections.
sessionId optional, can only be specified once.

Search for courses offered over the part of the semester with the given sessionId. The values for a sessionId are obtained by the /schedule/sessions query.
subject optional, can only be specified once. Search for courses offered in the given subject code abbreviation as used in the other Schedule resources (e.g. MATH, RHET).
collegeCode optional, can only be specified once. Search for courses offered by the given college code. The college code is the college code as it appears in the EDW.
creditHours optional, can only be specified once. Search for courses offered with the specified number of credit hours. Results will include ranges that have the given number of credit hours as a boundary (e.g. a search for courses offered that give 3 credit hours will return courses that offer '0 to 3 Hours.' but not '2 to 4 Hours.'))
gened optional, can only be specified once but with space-delimited (+-delimited) values (e.g. gened=HUM+NAT). Search for courses offered with the specified general education categories or subcategories.

Keyword Search Query Parameters

Optional keyword searches over course titles and descriptions, section titles, section information, and section degree attributes for a match. Matches are not case-sensitive. Specify exactly 1 of these parameters.
Parameter Value(s)
qs optional <KEYWORD>

Search course title and description containing <KEYWORD> (e.g. qs=analytical).
qp optional <PHRASE>

Search course title and description containing <PHRASE> (e.g. qp=introduction+to+business).
qw_a optional <ALL_WORDS>

Search course title and description containing <ALL_WORDS> regardless of the order specified (e.g. qw_a=analytics+mechanical). Search results will contain courses that have all the words in either their title or description.
qw_o optional <ANY_WORDS>

Search course title and description containing <ANY_WORDS> (e.g. qp=art+appreciation). Search results will contain courses that have any of the words in either their title or description. Courses will have at least one of the search terms in their title or description.

Example Raw HTTP Request

https://courses.illinois.edu/cisapi/schedule/courses?year=2012&term=spring§ionTypeCode=LEC§ionTypeCode=Q&collegeCode=KV&creditHours=3&subject=CHEM&sessionId=1&gened=NAT&qp=atomic+structure

Sample HTTP Request Headers

Sample HTTP Response Headers

Sample HTTP Response Body