SubjectsAPIv2

This API returns a list of all the subjects that have offering in the specified/default termCode.  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.

Endpoint: https://gw.its.yale.edu/soa-gateway/course/webservice/v2/subjects

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.

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

department

string optional

The accepted three/four-character code for the department.  This data may include ampersands which should be encoded as %26.  Example:   ENGL, ER&M, PLSC, G&G, ACT.   

Data Response

Name

Type

Description

code

string

Course subject code.  Example:  ACCT, AFAM, PLSC, ENGL, EP&E

description

string
Descriptive name of the subject.