API
Developer
REST API
Reference
Instructors

Instructors

The instructors endpoint allows users to get information on instructors who currently teach (or have taught) at UCI. This endpoint should include data on lecturers and professors, but most likely not graduate students in teaching roles, since information for the latter is not available through the General Catalogue.

Get an instructor with the given UCInetID

Code sample

curl "https://api-next.peterportal.org/v1/rest/instructors/mikes"

Response

{
  "ucinetid": "mikes",
  "name": "Michael Shindler",
  "shortenedName": "SHINDLER, M.",
  "title": "Associate Professor of Teaching",
  "email": "mikes@uci.edu",
  "department": "Computer Science",
  "schools": ["Donald Bren School of Information and Computer Sciences"],
  "relatedDepartments": ["COMPSCI", "IN4MATX", "I&C SCI", "SWE", "STATS"],
  "courseHistory": {
    "COMPSCI 162": ["2023 Spring", "2021 Spring", "2020 Spring"],
    "I&C SCI 193": ["2023 Spring"],
    "...": "..."
  }
}

Get courses that match the specified constraints

Query parameters

nameContains string

A substring of the instructors' names.

shortenedName string

The shortened name (i.e. WebSoc name) of the instructor(s).

:::caution

Using this parameter will typically only return one entry; however, in some cases, multiple instructors may share the same shortened name. This may be because one or more of the instructors are emeriti, or because the last name-first initial combo is too common. Be sure to double-check the response.

:::

titleContains string

A substring of the instructors' titles.

departmentContains string

A substring of the instructors' department names.

schoolsContains string | string[]

The set of schools with which the instructors are affiliated.

relatedDepartmentsContains string | string[]

The set of departments with which the instructors are affiliated.

taughtInTerms string | string[]

The term(s) in which the instructors taught at least one course.

Code sample

curl "https://api-next.peterportal.org/v1/rest/instructors"

Response

Get all instructors whose names contain the string "Eric"
curl "https://api-next.peterportal.org/v1/rest/instructors?nameContains=Eric"
[
  {
    "ucinetid": "crooksr",
    "name": "Roderic Nicholaus Crooks",
    "shortenedName": "CROOKS, R.",
    "...": "..."
  },
  "...",
  {
    "ucinetid": "emj",
    "name": "Eric D Mjolsness",
    "shortenedName": "MJOLSNESS, E.",
    "...": "..."
  },
  "..."
]
Get all instructors whose shortened name is "BLAKE, D."
curl "https://api-next.peterportal.org/v1/rest/instructors?shortenedName=BLAKE, D."
[
  {
    "ucinetid": "dhblake",
    "name": "David H Blake",
    "shortenedName": "BLAKE, D.",
    "...": "..."
  },
  {
    "ucinetid": "drblake",
    "name": "Donald R Blake",
    "shortenedName": "BLAKE, D.",
    "...": "..."
  }
]
Get all professors emeriti of the Computer Science department
curl "https://api-next.peterportal.org/v1/rest/instructors?titleContains=Emeritus&departmentContains=Computer%20Science"
[
  "...",
  {
    "ucinetid": "dhirschb",
    "name": "Dan Hirschberg",
    "shortenedName": "HIRSCHBERG, D.",
    "...": "..."
  },
  "...",
  {
    "ucinetid": "pattis",
    "name": "Richard Eric Pattis",
    "shortenedName": "PATTIS, R.",
    "...": "..."
  },
  "..."
]
Get all lecturers affiliated with the I&C SCI or PHYSICS departments
curl "https://api-next.peterportal.org/v1/rest/courses?titleContains=Lecturer&relatedDepartmentsContains=I%26C%20SCI,PHYSICS"
[
  {
    "ucinetid": "abahrehb",
    "name": "Amirfarshad Bahrehbakhsh",
    "shortenedName": "BAHREHBAKHSH, A.",
    "bar": "..."
  },
  "...",
  {
    "ucinetid": "alfaro",
    "name": "Shannon L Alfaro",
    "shortenedName": "ALFARO, S.",
    "bar": "..."
  },
  "..."
]
Get all department chairs who taught in 2023 Spring
curl "https://api-next.peterportal.org/v1/rest/instructors?titleContains=Department%20Chair&taughtInTerms=2023%20Spring"
[
  {
    "ucinetid": "abiendar",
    "name": "Anke Biendarra",
    "shortenedName": "BIENDARRA, A.",
    "...": "..."
  },
  {
    "ucinetid": "alexac15",
    "name": "Alexandre Chan",
    "shortenedName": "CHAN, A.",
    "...": "..."
  },
  "..."
]

Get all instructors

Code sample

curl "https://api-next.peterportal.org/v1/rest/instructors/all"

Response

[
  {
    "ucinetid": "aaaziz1",
    "...": "..."
  },
  {
    "ucinetid": "aabrewer",
    "...": "..."
  },
  "..."
]
GradesLARC