Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.2.0
info:
title: Student Web Service (SWS) Degree API
description: Student Web Service (SWS) provides a RESTful API to access and update central student data. Subscribe to http://mailman.u.washington.edu/mailman/listinfo/sws-client-app-dev to get notifications about planned outages, support and the announcement of new features.
contact:
name: Enterprise Web Services & Events Team
url: https://itconnect.uw.edu/service/enterprise-web-services-and-events/
email: sws-support@uw.edu
version: v5
termsOfService: https://www.washington.edu/online/terms/
servers:
- url: https://ws.admin.washington.edu/student
description: UW-IT Enterprise Web Services production host for the Student Web Service
externalDocs:
description: UW-IT Enterprise Web Services registry
url: https://webservices.washington.edu/sws/
tags:
- name: Degree
x-operator: institution
x-provenance:
method: derived
source: openapi/_original/university-of-washington-student-web-service.yaml
generated: '2026-08-30'
note: Re-based by the university pipeline on 2026-08-30. refine-openapis had welded the IdCard Web Service title/contact/base onto outputs split from the Student Web Service original; identity restored from the true parent named above and the relative base resolved to the production host published on the EWS registry.
paths:
/v5/degree/{major_abbr},{pathway},{level},{type},{year},{quarter}:
get:
tags:
- Degree
summary: Get a specific degree program that matches the supplied parameters
description: "<pre>\n {\n \"DisplayTitle\" : \"Degree\",\n \"ews_guid\" : \"7106549C-4066-485F-B6CA-2B03BF2D5D05\",\n \"LongDescription\" : \"Return a specific degree program that matches the supplied parameters\",\n \"ShortDescription\" : \"Return a specific degree program\",\n \"OriginatingSchema\" : [ { \"source\":\"swssdb\" } ],\n \"Notes\" : \"This resource requires any of the following ASTRA roles:\n - sws:Support\n - sws:UnitReader\n This resource supports the following authentication types:\n - X.509 Certificate\n - NetID\n - AccessToken\n A student can be enrolled in multiple degrees. Degrees are children of Programs (major/pathway).\",\n \"Links\" : [ \"https://metadata.uw.edu/Catalog/ViewItem/Term/studentdata.degree\" ],\n \"Synonyms\" : []\n }\n </pre>"
operationId: GetDegree
parameters:
- name: major_abbr
in: path
description: ''
required: true
schema:
type: string
default: ''
- name: pathway
in: path
description: ''
required: true
schema:
type: string
default: ''
- name: level
in: path
description: ''
required: true
schema:
type: string
default: ''
- name: type
in: path
description: ''
required: true
schema:
type: string
default: ''
- name: year
in: path
description: 'The 4 digit year. For example: 2025'
required: true
schema:
maxLength: 4
minLength: 4
type: string
default: ''
- name: quarter
in: query
description: 'The 1 digit quarter. For example: 0=Default, 1=winter, 2=spring, 3=summer, 4=autumn'
schema:
maxLength: 6
minLength: 6
type: string
default: ''
responses:
'400':
description: 'Invalid arg: year | Invalid arg: quarter'
'200':
description: OK
content:
text/html:
schema:
$ref: '#/components/schemas/DegreeViewModel'
application/xml:
schema:
$ref: '#/components/schemas/DegreeViewModel'
text/xml:
schema:
$ref: '#/components/schemas/DegreeViewModel'
text/plain:
schema:
$ref: '#/components/schemas/DegreeViewModel'
application/json:
schema:
$ref: '#/components/schemas/DegreeViewModel'
text/json:
schema:
$ref: '#/components/schemas/DegreeViewModel'
'202':
description: Accepted
'301':
description: MovedPermanently
'302':
description: Found
'304':
description: NotModified
'401':
description: Identity '{identity}' is not authorized to access this resource.
'405':
description: MethodNotAllowed
'500':
description: InternalServerError
'503':
description: ServiceUnavailable
/v5/degree:
get:
tags:
- Degree
summary: Search for a degree program that matches the supplied parameters
description: "<pre>\n {\n \"DisplayTitle\" : \"Degree Search\",\n \"ews_guid\" : \"F830EF22-38C3-4279-A199-9C8A8038C149\",\n \"LongDescription\" : \"Search for a degree program that matches the supplied parameters\",\n \"ShortDescription\" : \"Search for a degree program\",\n \"OriginatingSchema\" : [ { \"source\":\"swssdb\" } ],\n \"Notes\" : \"This resource requires any of the following ASTRA roles:\n - sws:Support\n - sws:UnitReader\n This resource supports the following authentication types:\n - X.509 Certificate\n - NetID\n - AccessToken\n A student can be enrolled in multiple degrees. Degrees are children of Programs (major/pathway).\",\n \"Links\" : [ \"https://metadata.uw.edu/Catalog/ViewItem/Term/studentdata.degree\" ],\n \"Synonyms\" : []\n }\n </pre>"
operationId: DegreeSearch
parameters:
- name: campus
in: query
description: ''
schema:
type: string
default: ''
- name: major_abbr
in: query
description: ''
schema:
type: string
default: ''
- name: pathway
in: query
description: ''
schema:
type: string
default: ''
- name: year
in: query
description: 'The 4 digit year. For example: 2025'
schema:
type: string
default: ''
- name: quarter
in: query
description: 'The 1 digit quarter. For example: 0=Default, 1=winter, 2=spring, 3=summer, 4=autumn'
schema:
type: string
default: ''
- name: page_size
in: query
description: ''
schema:
type: string
default: ''
- name: page_start
in: query
description: ''
schema:
type: string
default: ''
responses:
'400':
description: 'Invalid arg: year | Invalid arg: quarter | Invalid arg: major_abbr | Invalid arg: pathway'
'200':
description: OK
content:
text/html:
schema:
$ref: '#/components/schemas/DegreeSearchViewModel'
application/xml:
schema:
$ref: '#/components/schemas/DegreeSearchViewModel'
text/xml:
schema:
$ref: '#/components/schemas/DegreeSearchViewModel'
text/plain:
schema:
$ref: '#/components/schemas/DegreeSearchViewModel'
application/json:
schema:
$ref: '#/components/schemas/DegreeSearchViewModel'
text/json:
schema:
$ref: '#/components/schemas/DegreeSearchViewModel'
'202':
description: Accepted
'301':
description: MovedPermanently
'302':
description: Found
'304':
description: NotModified
'401':
description: Identity '{identity}' is not authorized to access this resource.
'405':
description: MethodNotAllowed
'500':
description: InternalServerError
'503':
description: ServiceUnavailable
components:
schemas:
DegreeResourceUri:
type: object
properties:
Href:
type:
- string
- 'null'
MajorAbbreviation:
type:
- string
- 'null'
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_major_code.major_abbr\" }\n ],\n \"TechnicalDescription\": \"Major Abbreviation\"\n }\n </pre>"
Pathway:
type:
- string
- 'null'
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_major_code.major_pathway\" }\n ],\n \"TechnicalDescription\": \"Pathway\"\n }\n </pre>"
DegreeLevel:
type:
- string
- 'null'
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_degree.deg_level\" }\n ],\n \"TechnicalDescription\": \"Degree Level\"\n }\n </pre>"
DegreeType:
type:
- string
- 'null'
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_degree.deg_type\" }\n ],\n \"TechnicalDescription\": \"Degree Type\"\n }\n </pre>"
Year:
type: integer
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_degree.deg_first_yr\" },\n { \"source\":\"SWSSDB.sr_degree.deg_last_yr\" }\n ],\n \"TechnicalDescription\": \"Year\"\n }\n </pre>"
format: int32
Quarter:
type:
- string
- 'null'
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_degree.deg_first_qtr\" },\n { \"source\":\"SWSSDB.sr_degree.deg_last_qtr\" }\n ],\n \"TechnicalDescription\": \"Quarter\"\n }\n </pre>"
additionalProperties: false
description: "{\n \"DisplayTitle\" : \"Degree Resource URI\",\n \"TargetSchema\" : [{\"target\" : \"SWS.Degree\"}],\n \"TargetOperationId\" : [\"GetDegree\"]\n}"
DegreeSearchResourceUri:
type: object
properties:
CampusShortName:
type:
- string
- 'null'
Year:
type: integer
format: int32
Quarter:
type:
- string
- 'null'
Pathway:
type:
- string
- 'null'
MajorAbbreviation:
type:
- string
- 'null'
PageStart:
type:
- string
- 'null'
PageSize:
type:
- string
- 'null'
Href:
type:
- string
- 'null'
additionalProperties: false
description: "{\n \"DisplayTitle\" : \"Degree Search Resource URI\",\n \"TargetSchema\" : [{\"target\" : \"SWS.Degree\"}],\n \"TargetOperationId\" : [\"DegreeSearch\"]\n}"
TermResourceUri:
type: object
properties:
Href:
type:
- string
- 'null'
Year:
type: integer
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_major_code.major_last_yr\" },\n { \"source\":\"SWSSDB.sr_major_code.major_first_yr\" },\n { \"source\":\"SWSSDB.sys_tbl_39_calendar.table_key\" },\n { \"source\":\"SWSSDB.student_1.last_yr_enrolled\" },\n { \"source\":\"SDB.SWI610.trm/yr\" },\n { \"source\":\"SWSSDB.sr_course_titles.first_eff_yr\" },\n { \"source\":\"UWEO.selSWSRegistrations.FirstEffectiveTerm/Year\"}\n ],\n \"TechnicalDescription\": \"Year for the given term\"\n }\n </pre>"
format: int32
Quarter:
type:
- string
- 'null'
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_major_code.major_last_qtr\" },\n { \"source\":\"SWSSDB.sr_major_code.major_first_qtr\" },\n { \"source\":\"SWSSDB.sys_tbl_39_calendar.table_key\" },\n { \"source\":\"SWSSDB.student_1.last_qtr_enrolled\" },\n { \"source\":\"SDB.SWI610.trm/qtr\" },\n { \"source\":\"SWSSDB.sr_course_titles.first_eff_qtr\" },\n { \"source\":\"UWEO.selSWSRegistrations.FirstEffectiveTerm/Quarter\"}\n ],\n \"TechnicalDescription\": \"Quarter for the given term\"\n }\n </pre>"
additionalProperties: false
description: "{\n \"DisplayTitle\" : \"Term Resource URI\",\n \"TargetSchema\" : [{\"target\" : \"SWS.Term\"}],\n \"TargetOperationId\" : [\"GetTerm\"]\n}"
DepartmentViewModel:
type: object
properties:
CollegeAbbreviation:
type:
- string
- 'null'
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_dept_code.dept_college\" }\n ],\n \"TechnicalDescription\": \"College Abbreviation\"\n }\n </pre>"
DepartmentAbbreviation:
type:
- string
- 'null'
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_dept_code.dept_abbr\" }\n ],\n \"TechnicalDescription\": \"Department Abbreviation\"\n }\n </pre>"
DepartmentFullName:
type:
- string
- 'null'
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_dept_code.dept_full_nm\" }\n ],\n \"TechnicalDescription\": \"Department Full Name\"\n }\n </pre>"
additionalProperties: false
description: "{\n \"DisplayTitle\" : \"Department Model\",\n \"TargetSchema\" : [{\"target\" : \"SWS.Department\"}]\n}"
ProgramResourceUri:
type: object
properties:
Href:
type:
- string
- 'null'
MajorAbbreviation:
type:
- string
- 'null'
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_major_code.major_abbr\" }\n ],\n \"TechnicalDescription\": \"Major Abbreviation\"\n }\n </pre>"
Pathway:
type:
- string
- 'null'
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_major_code.major_pathway\" }\n ],\n \"TechnicalDescription\": \"Pathway\"\n }\n </pre>"
Year:
type: integer
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_major_code.major_first_yr\" },\n { \"source\":\"SWSSDB.sr_major_code.major_last_yr\" }\n ],\n \"TechnicalDescription\": \"Year\"\n }\n </pre>"
format: int32
Quarter:
type:
- string
- 'null'
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_major_code.major_first_qtr\" },\n { \"source\":\"SWSSDB.sr_major_code.major_last_qtr\" }\n ],\n \"TechnicalDescription\": \"Quarter\"\n }\n </pre>"
additionalProperties: false
description: "{\n \"DisplayTitle\" : \"Program Resource URI\",\n \"TargetSchema\" : [{\"target\" : \"SWS.Program\"}],\n \"TargetOperationId\" : [\"GetProgram\"]\n}"
ProgramViewModel:
type: object
properties:
ProgramUri:
$ref: '#/components/schemas/ProgramResourceUri'
Department:
$ref: '#/components/schemas/DepartmentViewModel'
MajorFullName:
type:
- string
- 'null'
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_major_code.major_full_nm\" }\n ],\n \"TechnicalDescription\": \"Full name\"\n }\n </pre>"
MajorName:
type:
- string
- 'null'
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_major_code.major_name\" }\n ],\n \"TechnicalDescription\": \"Name\"\n }\n </pre>"
MajorShortName:
type:
- string
- 'null'
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_major_code.major_short_nm\" }\n ],\n \"TechnicalDescription\": \"Short name\"\n }\n </pre>"
Pathway:
type:
- string
- 'null'
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_major_code.major_pathway\" }\n ],\n \"TechnicalDescription\": \"Pathway\"\n }\n </pre>"
FirstEffectiveTerm:
$ref: '#/components/schemas/TermResourceUri'
LastEffectiveTerm:
$ref: '#/components/schemas/TermResourceUri'
Href:
type:
- string
- 'null'
additionalProperties: false
description: "{\n \"DisplayTitle\" : \"Program Model\",\n \"TargetSchema\" : [{\"target\" : \"SWS.Program\"}]\n}"
DegreeViewModel:
type: object
properties:
DegreeUri:
$ref: '#/components/schemas/DegreeResourceUri'
Program:
$ref: '#/components/schemas/ProgramViewModel'
Campus:
type:
- string
- 'null'
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sys_tbl_25_campus.branch_name\" }\n ],\n \"TechnicalDescription\": \"Campus name\"\n }\n </pre>"
DegreeLevel:
type:
- string
- 'null'
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_degree.deg_level\" }\n ],\n \"TechnicalDescription\": \"Degree level\"\n }\n </pre>"
DegreeType:
type:
- string
- 'null'
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_degree.deg_type\" }\n ],\n \"TechnicalDescription\": \"Degree type\"\n }\n </pre>"
Title:
type:
- string
- 'null'
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_degree.deg_title\" }\n ],\n \"TechnicalDescription\": \"Title\"\n }\n </pre>"
FirstEffectiveTerm:
$ref: '#/components/schemas/TermResourceUri'
LastEffectiveTerm:
$ref: '#/components/schemas/TermResourceUri'
Href:
type:
- string
- 'null'
additionalProperties: false
description: "{\n \"DisplayTitle\" : \"Degree Model\",\n \"TargetSchema\" : [{\"target\" : \"SWS.Degree\"}]\n}"
DegreeSearchViewModel:
type: object
properties:
Current:
$ref: '#/components/schemas/DegreeSearchResourceUri'
Next:
$ref: '#/components/schemas/DegreeSearchResourceUri'
Previous:
$ref: '#/components/schemas/DegreeSearchResourceUri'
TotalCount:
type: integer
format: int32
Degrees:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/DegreeViewModel'
readOnly: true
additionalProperties: false
description: "{\n \"DisplayTitle\" : \"Degree Search Model\",\n \"TargetSchema\" : [{\"target\" : \"SWS.Degree\"}]\n}"