Grades
PeterPortal API maintains a database of past grades dating back to 2014 Summer Session 1. This database is updated from the Public Records Office (opens in a new tab) as soon as they are available. This endpoint allows users to query that database with any desired filters.
Please note that due to the size of the database, not providing any filters for the grades statistics endpoints will most likely result in an error. If you must fetch all data from the database at once, please consider doing so by year.
Query parameters for all endpoints
year string
The year to include.
quarter Fall | Winter | Spring | Summer1 | Summer10wk | Summer2
The quarter to include. Case-sensitive.
instructor string
The shortened name of the instructor to include. (Ex.: SHINDLER, M.)
department string
The department to include.
courseNumber string
The course number to include. (Ex.: 161)
sectionCode string
The five-digit section code to include.
division LowerDiv | UpperDiv | Graduate
The course level/division code to include. Case-sensitive.
ge GE-1A | GE-1B | GE-2 | GE-3 | GE-4 | GE-5A | GE-5B | GE-6 | GE-7 | GE-8
Which GE category to include. Case-sensitive.
excludePNP boolean
Whether to exclude sections that only reported Pass/No-Pass grades.
Get raw grade statistics for certain sections
Code sample
curl "https://api-next.peterportal.org/v1/rest/grades/raw?year=2022&quarter=Fall§ionCode=35730"Response
[
{
"year": "2022",
"quarter": "Fall",
"sectionCode": "35730",
"department": "I&C SCI",
"courseNumber": "46",
"courseNumeric": 46,
"geCategories": ["GE-5B"],
"gradeACount": 34,
"gradeBCount": 19,
"gradeCCount": 40,
"gradeDCount": 0,
"gradeFCount": 18,
"gradePCount": 3,
"gradeNPCount": 5,
"gradeWCount": 4,
"averageGPA": 2.45,
"instructors": ["GARZA RODRIGUE, A.", "GILA, O.", "SHINDLER, M."]
}
]Get aggregate grade statistics for certain sections
Code sample
curl "https://api-next.peterportal.org/v1/rest/grades/aggregate?year=2022&quarter=Fall&courseNumber=46"Response
{
"sectionList": [
{
"year": "2022",
"quarter": "Fall",
"sectionCode": "35730",
"department": "I&C SCI",
"courseNumber": "46",
"courseNumeric": 46,
"geCategories": ["GE-5B"],
"instructors": ["GARZA RODRIGUE, A.", "GILA, O.", "SHINDLER, M."]
},
{
"year": "2022",
"quarter": "Fall",
"sectionCode": "35740",
"department": "I&C SCI",
"courseNumber": "46",
"courseNumeric": 46,
"geCategories": ["GE-5B"],
"instructors": ["DICKERSON, M.", "SHINDLER, M."]
}
],
"gradeDistribution": {
"gradeACount": 95,
"gradeBCount": 83,
"gradeCCount": 103,
"gradeDCount": 0,
"gradeFCount": 33,
"gradePCount": 4,
"gradeNPCount": 7,
"gradeWCount": 10,
"averageGPA": 2.63
}
}Get lists of valid options for the given filters
Code sample
curl "https://api-next.peterportal.org/v1/rest/grades/options?department=COMPSCI"Response
{
"years": [
"2022",
"2021",
"2020",
"2019",
"2018",
"2017",
"2016",
"2015",
"2014"
],
"departments": ["COMPSCI"],
"courseNumbers": [
"103",
"111",
"112",
"113",
"114",
"115",
"116",
"117",
"118",
"..."
],
"sectionCodes": [
"34000",
"34010",
"34015",
"34020",
"34030",
"34035",
"34040",
"34050",
"34055",
"34060",
"..."
],
"instructors": [
"ABBASPOUR TEHR, M.",
"ABDU JYOTHI, S.",
"ABRAHAM, D.",
"ADDANKI, G.",
"ADHIKARI, A.",
"AGARWAL, N.",
"AGNIHOTRI, M.",
"AHMED, I.",
"AL SUDAIS, S.",
"..."
]
}Get grade statistics aggregated by course for certain sections
Formally, if two sections have the same department code and course number, then they will be aggregated together for the purposes of this endpoint. For queries that involve an entire department, this is equivalent to running an aggregate query for each course number, but much faster.
Note that graduate students who are listed as instructors on WebSoc may also be included.
Code sample
curl "https://api-next.peterportal.org/v1/rest/grades/aggregateByCourse?year=2023&department=COMPSCI"Response
[
{
"department": "COMPSCI",
"courseNumber": "103",
"gradeACount": 80,
"gradeBCount": 11,
"gradeCCount": 10,
"gradeDCount": 4,
"gradeFCount": 5,
"gradePCount": 11,
"gradeNPCount": 8,
"gradeWCount": 0,
"averageGPA": 3.415
},
{
"department": "COMPSCI",
"courseNumber": "111",
"gradeACount": 112,
"gradeBCount": 100,
"gradeCCount": 35,
"gradeDCount": 13,
"gradeFCount": 13,
"gradePCount": 13,
"gradeNPCount": 2,
"gradeWCount": 2,
"averageGPA": 3.11625
},
"..."
]Get grade statistics aggregated by course/instructor for certain sections
Formally, if two sections have the same department code, course number, and instructor name, then they will be aggregated together for the purposes of this endpoint. For queries that involve an entire department, this is equivalent to running an aggregate query for each course number-instructor pair, but much faster.
Note that graduate students who are listed as instructors on WebSoc may also be included.
Code sample
curl "https://api-next.peterportal.org/v1/rest/grades/aggregateByOffering?year=2023&department=COMPSCI&courseNumber=161"Response
[
{
"department": "COMPSCI",
"courseNumber": "161",
"instructor": "FRISHBERG, D.",
"gradeACount": 165,
"gradeBCount": 42,
"gradeCCount": 59,
"gradeDCount": 0,
"gradeFCount": 14,
"gradePCount": 0,
"gradeNPCount": 0,
"gradeWCount": 2,
"averageGPA": 3.23
},
{
"department": "COMPSCI",
"courseNumber": "161",
"instructor": "KALOGIANNIS, F.",
"gradeACount": 165,
"gradeBCount": 42,
"gradeCCount": 59,
"gradeDCount": 0,
"gradeFCount": 14,
"gradePCount": 0,
"gradeNPCount": 0,
"gradeWCount": 2,
"averageGPA": 3.23
},
{
"department": "COMPSCI",
"courseNumber": "161",
"instructor": "PANAGEAS, I.",
"gradeACount": 101,
"gradeBCount": 115,
"gradeCCount": 48,
"gradeDCount": 15,
"gradeFCount": 12,
"gradePCount": 0,
"gradeNPCount": 0,
"gradeWCount": 2,
"averageGPA": 2.935
},
{
"department": "COMPSCI",
"courseNumber": "161",
"instructor": "SHINDLER, M.",
"gradeACount": 165,
"gradeBCount": 42,
"gradeCCount": 59,
"gradeDCount": 0,
"gradeFCount": 14,
"gradePCount": 0,
"gradeNPCount": 0,
"gradeWCount": 2,
"averageGPA": 3.23
}
]