Student Web Service (SWS) Department API — a resource of the UW-IT Student Web Service, split out per resource by the API Evangelist refine step from the institution-published SWS v5 OpenAPI. Specification public; data gated by UW NetID / X.509 client certificate and named ASTRA roles.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/university-of-washington-department-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Student Web Service (SWS) Department 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: Department
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/department:
get:
tags:
- Department
summary: Search for departments that match the supplied parameters
description: "<pre>\n {\n \"DisplayTitle\" : \"Department Search\",\n \"ews_guid\" : \"D9639897-147A-4091-955A-549E643B70A2\",\n \"LongDescription\" : \"Display a list of departments by college_abbreviation and optionally filter on year, quarter and\n future_terms\",\n \"ShortDescription\" : \"List of departments\",\n \"OriginatingSchema\" : [ { \"source\":\"swssdb\" } ],\n \"Notes\" : \"This resource requires any of the following ASTRA roles:\n - sws:Support\n - sws:GradeSubmitter\n - sws:UnitReader\n This resource supports the following authentication types:\n - X.509 Certificate\n - NetID\n - AccessToken \",\n \"Links\" : [ \"https://metadata.uw.edu/Catalog/ViewItem/Term/studentdata.department\" ],\n \"Synonyms\" : []\n }\n </pre>"
operationId: DepartmentSearch
parameters:
- 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: future_terms
in: query
description: Number of future terms to look ahead
schema:
type: integer
format: int32
default: 0
- name: college_abbreviation
in: query
description: ''
schema:
type: string
default: ''
responses:
'400':
description: Invalid input | DepartmentSearch only supports searches using 1 param.
'200':
description: OK
content:
text/html:
schema:
$ref: '#/components/schemas/DepartmentSearchViewModel'
application/xml:
schema:
$ref: '#/components/schemas/DepartmentSearchViewModel'
text/xml:
schema:
$ref: '#/components/schemas/DepartmentSearchViewModel'
text/plain:
schema:
$ref: '#/components/schemas/DepartmentSearchViewModel'
application/json:
schema:
$ref: '#/components/schemas/DepartmentSearchViewModel'
text/json:
schema:
$ref: '#/components/schemas/DepartmentSearchViewModel'
'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:
DepartmentSearchViewModel:
type: object
properties:
TotalCount:
type: integer
format: int32
Departments:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/DepartmentResourceUri'
readOnly: true
Current:
$ref: '#/components/schemas/DepartmentSearchResourceUri'
Next:
$ref: '#/components/schemas/DepartmentSearchResourceUri'
Previous:
$ref: '#/components/schemas/DepartmentSearchResourceUri'
PageSize:
type:
- string
- 'null'
PageStart:
type:
- string
- 'null'
additionalProperties: false
description: "{\n \"DisplayTitle\" : \"Department Search Model\",\n \"TargetSchema\" : [{\"target\" : \"SWS.Department\"}]\n}"
DepartmentSearchResourceUri:
type: object
properties:
CollegeAbbreviation:
type:
- string
- 'null'
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_dept_code.dept_college\" }\n ],\n \"TechnicalDescription\": \"CollegeAbbreviation\"\n }\n </pre>"
FutureTerms:
type: integer
format: int32
Quarter:
type:
- string
- 'null'
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_major_code.major_first_qtr\" }\n ],\n \"TechnicalDescription\": \"Quarter\"\n }\n </pre>"
Year:
type:
- string
- 'null'
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_major_code.major_first_yr\" }\n ],\n \"TechnicalDescription\": \"Year\"\n }\n </pre>"
Href:
type:
- string
- 'null'
additionalProperties: false
description: "{\n \"DisplayTitle\" : \"Department Search Resource URI\",\n \"TargetSchema\" : [{\"target\" : \"SWS.Department\"}],\n \"TargetOperationId\" : [\"DepartmentSearch\"]\n}"
DepartmentResourceUri:
type: object
properties:
DepartmentAbbreviation:
type:
- string
- 'null'
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_dept_code.dept_abbr\" }\n ],\n \"TechnicalDescription\": \"DepartmentAbbreviation\"\n }\n </pre>"
DepartmentFullName:
type:
- string
- 'null'
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_dept_code.dept_full_nm\" }\n ],\n \"TechnicalDescription\": \"DepartmentFullName\"\n }\n </pre>"
Quarter:
type:
- string
- 'null'
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_major_code.major_first_qtr\" }\n ],\n \"TechnicalDescription\": \"Quarter\"\n }\n </pre>"
Year:
type: integer
description: "<pre>\n {\n \"OriginatingSchema\" : [\n { \"source\":\"SWSSDB.sr_major_code.major_first_yr\" }\n ],\n \"TechnicalDescription\": \"Year\"\n }\n </pre>"
format: int32
Href:
type:
- string
- 'null'
additionalProperties: false
description: "{\n \"DisplayTitle\" : \"Department Resource URI\",\n \"TargetSchema\" : [{\"target\" : \"SWS.Department\"}],\n \"TargetOperationId\" : [\"DepartmentSearch\"]\n}"